React Native SDK

Use the smartlinks JavaScript package together with the react-native-smartlinks native bridge. The examples here use the published 2.0.3 releases and require an iOS/Android native build.

Install

npm install smartlinks@^2.0.3 react-native-smartlinks@^2.0.3 react-native-safe-area-context

For iOS, run pod install from your ios directory. Rebuild the native app after installation; refreshing Metro does not install native modules. Expo Go does not contain this custom bridge—use a native development build with the required platform setup.

Feedback file attachments additionally use react-native-document-picker; add it only when that workflow is needed.

Initialize once

Run initialization in your app's startup flow before calling analytics or opening SDK screens:

import { SmartLinks } from 'smartlinks';

await SmartLinks.initialize({
  apiKey: 'YOUR_API_KEY',
  isDebug: __DEV__,
  initializeAds: false,
  appVersion: '1.0.0', // Replace with your actual app version.
});

SmartLinks.analytics.sendEvent('integration_test', { screen: 'home' });

SmartLinks.analytics.getLink((route) => {
  // Validate route.route and route.params.
  // Navigate only after your app's navigator is ready.
});

Keep the public placeholder unchanged in shared examples. Supply your app-specific key only in your own development/build configuration. Catch initialization errors in the host app and keep normal startup usable during a network failure.

Android links

The native bridge resolves its core SDK from Maven Central. Configure your actual application ID and signing fingerprints in SmartLinks, and add a link filter to the receiving Android Activity:

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https"
          android:host="smartlinks.live"
          android:pathPrefix="/l/YOUR_APP_SLUG/" />
</intent-filter>

Replace the slug and domain. Short links use different paths; include the routes you actually distribute rather than assuming this long-form example covers them all.

iOS links

Autolinking uses CocoaPods. Add Associated Domains with applinks:smartlinks.live or your configured domain, and check the Apple Team ID and bundle identifier in the private dashboard. Follow the native setup reference when wiring AppDelegate or SceneDelegate link callbacks.

Optional modules

Provide the appropriate navigation adapter when opening a screen. Configure community authentication, ads and AI Gateway separately before enabling them. Provider secrets stay in private server-side configuration.

Verify and learn more

Send integration_test from a native build and confirm it in the matching app's private analytics page. Test deep links on devices before shipping.

• Published JavaScript package
• Published native bridge
• Native setup reference
• API keys and troubleshooting