Cross-platform frameworks add a layer between your app code and the native platform. Deep linking SDKs need to bridge this gap: the native OS delivers the URL, the SDK processes it, and the result reaches your JavaScript, Dart, or TypeScript code. This guide covers SDK integration patterns for the major cross-platform frameworks.<\/p>\n\n\n\n
For framework-specific deep linking setup (without an SDK), see React Native Deep Linking<\/a> and Flutter Deep Linking<\/a>. For the SDK feature comparison, see Deferred Deep Linking SDKs: Feature Comparison<\/a>.<\/p>\n\n\n\n You can implement basic deep linking without any SDK. The OS delivers the URL, and your router handles it. An SDK adds value when you need:<\/p>\n\n\n\n If you only need direct deep linking (app is installed, user taps link, app opens to the right screen), the platform's built-in linking APIs are sufficient. No SDK required.<\/p>\n\n\n\n The React Native SDK still requires the same native configuration as manual deep linking:<\/p>\n\n\n\n The SDK doesn't replace this configuration; it adds deferred linking and analytics on top of it.<\/p>\n\n\n\n See the React Native SDK docs<\/a> for the full API reference.<\/p>\n\n\n\n Same as React Native: the Flutter SDK requires Associated Domains (iOS) and intent filters (Android) to be configured in the native project.<\/p>\n\n\n\n See the Flutter SDK docs<\/a> for the full API reference.<\/p>\n\n\n\n Capacitor apps use the Add Associated Domains in Xcode (same as native iOS or React Native).<\/p>\n\n\n\n Add intent filters to Since Capacitor runs a web view, you can use the Tolinku Web SDK for analytics and link creation:<\/p>\n\n\n\n For deferred deep linking in Capacitor, combine the native deep link listener with a server-side check:<\/p>\n\n\n\nWhy Use an SDK<\/h2>\n\n\n\n
\n
React Native Integration<\/h2>\n\n\n\n
Installation<\/h3>\n\n\n\n
npm install @tolinku\/react-native-sdk\n# or\nyarn add @tolinku\/react-native-sdk\n\ncd ios && pod install\n<\/code><\/pre>\n\n\n\nInitialization<\/h3>\n\n\n\n
import { Tolinku } from '@tolinku\/react-native-sdk';\n\n\/\/ Initialize early in your app's entry point\nTolinku.init({\n apiKey: 'tolk_pub_your_publishable_key',\n});\n<\/code><\/pre>\n\n\n\nDeferred Deep Link Handling<\/h3>\n\n\n\n
import { Tolinku } from '@tolinku\/react-native-sdk';\n\nuseEffect(() => {\n \/\/ Check for deferred deep link on first launch\n Tolinku.checkDeferredLink().then((result) => {\n if (result) {\n navigation.navigate(result.screen, result.params);\n }\n });\n}, []);\n<\/code><\/pre>\n\n\n\nLink Creation<\/h3>\n\n\n\n
const link = await Tolinku.createLink({\n path: '\/invite\/' + userId,\n campaign: 'referral',\n ogTitle: 'Join me on the app',\n ogDescription: 'Use my referral link to get started',\n});\n\/\/ link.url = "https:\/\/go.yourapp.com\/abc123"\n<\/code><\/pre>\n\n\n\nNative Setup<\/h3>\n\n\n\n
\n
continueUserActivity<\/code> handler<\/li>\nautoVerify<\/code>, Digital Asset Links file<\/li>\n<\/ul>\n\n\n\nFlutter Integration<\/h2>\n\n\n\n
Installation<\/h3>\n\n\n\n
# pubspec.yaml\ndependencies:\n tolinku: ^1.0.0\n<\/code><\/pre>\n\n\n\nInitialization<\/h3>\n\n\n\n
import 'package:tolinku\/tolinku.dart';\n\nvoid main() {\n Tolinku.init(apiKey: 'tolk_pub_your_publishable_key');\n runApp(MyApp());\n}\n<\/code><\/pre>\n\n\n\nDeferred Deep Link Handling<\/h3>\n\n\n\n
import 'package:tolinku\/tolinku.dart';\n\nclass _MyAppState extends State<MyApp> {\n @override\n void initState() {\n super.initState();\n _checkDeferredLink();\n }\n\n Future<void> _checkDeferredLink() async {\n final result = await Tolinku.checkDeferredLink();\n if (result != null) {\n router.go(result.path);\n }\n }\n}\n<\/code><\/pre>\n\n\n\nLink Creation<\/h3>\n\n\n\n
final link = await Tolinku.createLink(\n path: '\/invite\/$userId',\n campaign: 'referral',\n ogTitle: 'Join me on the app',\n ogDescription: 'Use my referral link to get started',\n);\n\/\/ link.url = "https:\/\/go.yourapp.com\/abc123"\n<\/code><\/pre>\n\n\n\nNative Setup<\/h3>\n\n\n\n
Capacitor \/ Ionic Integration<\/h2>\n\n\n\n
@capacitor\/app<\/code> plugin to receive deep links, similar to React Native's Linking module.<\/p>\n\n\n\nConfiguration<\/h3>\n\n\n\n
\/\/ capacitor.config.ts\nconst config: CapacitorConfig = {\n appId: 'com.yourapp',\n plugins: {\n App: {\n \/\/ Deep linking configuration\n },\n },\n};\n<\/code><\/pre>\n\n\n\niOS Setup<\/h3>\n\n\n\n
Android Setup<\/h3>\n\n\n\n
AndroidManifest.xml<\/code> (same as native Android).<\/p>\n\n\n\nLink Handling<\/h3>\n\n\n\n
import { App } from '@capacitor\/app';\n\nApp.addListener('appUrlOpen', (event) => {\n const url = new URL(event.url);\n const path = url.pathname;\n const params = Object.fromEntries(url.searchParams);\n\n \/\/ Route to the correct page\n router.navigateByUrl(path);\n});\n<\/code><\/pre>\n\n\n\nUsing Tolinku Web SDK in Capacitor<\/h3>\n\n\n\n
import { Tolinku } from '@tolinku\/web-sdk';\n\nTolinku.init({ apiKey: 'tolk_pub_your_publishable_key' });\n\n\/\/ Create a link\nconst link = await Tolinku.createLink({\n path: '\/invite\/' + userId,\n});\n<\/code><\/pre>\n\n\n\nApp.addListener('appUrlOpen', async (event) => {\n \/\/ Handle direct deep links\n handleDeepLink(event.url);\n});\n\n\/\/ On first launch, check for deferred link\nconst deferred = await fetch('https:\/\/api.tolinku.com\/v1\/deferred-link', {\n method: 'POST',\n headers: { 'x-api-key': 'tolk_pub_your_key' },\n body: JSON.stringify({ fingerprint: getDeviceFingerprint() }),\n});\n<\/code><\/pre>\n\n\n\nIntegration Architecture<\/h2>\n\n\n\n
Where the SDK Fits<\/h3>\n\n\n\n
User taps link\n \u2502\n \u25bc\nOS receives URL \u2192 checks App Links \/ Universal Links\n \u2502\n \u25bc\nApp launches (or comes to foreground)\n \u2502\n \u25bc\nNative layer receives URL\n \u2502\n \u25bc\nSDK processes URL:\n - Records click event\n - Extracts parameters\n - Checks for deferred link (first launch only)\n \u2502\n \u25bc\nCross-platform bridge (React Native bridge \/ Flutter platform channel)\n \u2502\n \u25bc\nYour JavaScript\/Dart code receives parsed result\n \u2502\n \u25bc\nRouter navigates to the correct screen\n<\/code><\/pre>\n\n\n\nWhat the SDK Handles<\/h3>\n\n\n\n