flinku-react-native

Version 0.7.6 - React Native SDK for Flinku. Deferred deep linking for iOS and Android.

Firebase Dynamic Links shut down in August 2025. If you are migrating off Firebase Dynamic Links, flinku-react-native is a maintained alternative: configure your subdomain, call match() on first launch, and route users to the right screen after install.

Installation

npm install flinku-react-native @react-native-async-storage/async-storage

Usage

import { Flinku } from 'flinku-react-native';

const flinku = new Flinku({
  userId: 'firebase-user-uid',
  baseUrl: 'https://yourapp.flku.dev', // must be your *.flku.dev subdomain
  apiKey: 'flk_pk_...',
  customDomain: 'links.example.com', // optional: your verified custom link domain (host only)
});

// On app launch — match deferred deep link
const link = await flinku.match();
if (link) {
  console.log(link.deepLink); // 'yourapp://screen'
  console.log(link.params);   // { ref: 'instagram', promo: 'SAVE20' }
  // Navigate to the right screen
}

// Create a link programmatically
// Use your publishable key (flk_pk_) in apps. Never embed your secret key (flk_live_).
const flinkuWithKey = new Flinku({
  userId: 'firebase-user-uid',
  baseUrl: 'https://yourapp.flku.dev',
  apiKey: 'flk_pk_...',
});

const created = await flinkuWithKey.createLink({
  title: 'Summer Campaign',
  deepLink: 'yourapp://promo',
  params: { ref: 'instagram', promo: 'SAVE20' },
});
console.log(created.shortUrl); // 'https://yourapp.flku.dev/summer-campaign'

Referrals

flinku.setUserId(user.id);          // after signup or login
flinku.qualifyReferral('purchase'); // when the referred user does the thing you reward

License

MIT