SDKs

Tolinku provides official SDKs for all major platforms. Each SDK handles deep link resolution, deferred deep linking, event tracking, referrals, smart banners (or in-app messages), and analytics batching out of the box.

Available SDKs

Platform	Package	Registry	Min Version
Web (JS/TS)	`@tolinku/web-sdk`	npm	ES2020 / Node 18+
iOS (Swift)	`TolinkuSDK`	Swift Package Manager	iOS 15+
Android (Kotlin)	`com.tolinku:sdk`	Maven Central	API 21+
React Native	`@tolinku/react-native-sdk`	npm	React Native 0.72+
Flutter (Dart)	`tolinku`	pub.dev	Flutter 3.10+ / Dart 3.0+

Common features

Every SDK provides the same core capabilities:

Event tracking with automatic batching (10 events or 5-second timer) and retry on failure. Events are flushed automatically when the app goes to the background. Event types are auto-prefixed with custom. if not already included.

Deferred deep linking to claim the original link destination after a user installs your app. Token-based claiming (Android) and signal-based fingerprint matching (iOS) are both supported.

Referral management to create codes, track milestones, complete referrals, and query the leaderboard.

In-app messages fetched from the API and rendered in a WebView (mobile) or DOM modal (web).

Ecommerce tracking (paid plans) with 13 event types covering the full shopping journey: product views, cart management, checkout, purchase, refund, search, ratings, and more. Revenue is batched and sent to the ecommerce API with automatic cart ID lifecycle management.

Initialization pattern

All SDKs follow a similar pattern:

Call a configure or init method with your publishable API key.
Set the user ID (optional, for segment targeting and analytics attribution).
Start tracking events and handling deep links.

// Web
const tolinku = new Tolinku({ apiKey: 'tolk_pub_...' });
tolinku.setUserId('user_123');
tolinku.track('custom.page_view');

// iOS
try Tolinku.configure(apiKey: "tolk_pub_...")
Tolinku.shared?.setUserId("user_123")
await Tolinku.shared?.track("custom.app_open")

// Android
Tolinku.configure(apiKey = "tolk_pub_...", context = this)
Tolinku.setUserId("user_123")
Tolinku.track("custom.app_open")

Platform guides

Web SDK Browser and Node.js integration.

iOS SDK Swift Package Manager setup and Universal Links.

Android SDK Gradle setup and App Links.

React Native SDK Cross-platform deep linking for React Native.

Flutter SDK Dart package for Flutter apps.