Firebase Dynamic Links Migration

Firebase Dynamic Links is deprecated and will shut down on August 25, 2025. This guide helps you migrate to Clippr with minimal disruption.

Why Migrate to Clippr?

• Similar API: Designed to feel familiar to Firebase users
• Better attribution: Install Referrer support for 100% accuracy on Android
• Modern architecture: Built for scale and reliability
• Active development: New features and improvements
• Fair pricing: Generous free tier and transparent pricing

Migration Overview

1. Create Clippr account and app
2. Update SDK dependencies
3. Update code (minimal changes)
4. Update Universal Links / App Links configuration
5. Create new links in Clippr
6. Redirect old links (optional)
7. Test and deploy

Step 1: Create Clippr Account

1. Sign up at app.useclippr.xyz
2. Create an organization
3. Create an app with your iOS/Android configuration
4. Copy your API key

Step 2: Update Dependencies

# pubspec.yaml - Remove these
dependencies:
firebase_dynamic_links: ^5.0.0  # Remove

dependencies:
clippr: ^0.0.4

# Podfile - Remove these
pod 'FirebaseDynamicLinks'

pod 'ClipprSDK', '~> 0.0.4'

https://github.com/nexlabstudio/clippr-ios.git

// build.gradle.kts - Remove
implementation("com.google.firebase:firebase-dynamic-links-ktx")

implementation("xyz.useclippr:clippr:0.0.4")

Step 3: Update Code

Initialization

import 'package:firebase_dynamic_links/firebase_dynamic_links.dart';

void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();
runApp(MyApp());
}

import 'package:clippr/clippr.dart';

void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Clippr.initialize(apiKey: 'YOUR_API_KEY');
runApp(MyApp());
}

import FirebaseDynamicLinks

FirebaseApp.configure()

import ClipprSDK

Clippr.initialize(apiKey: "YOUR_API_KEY")

// Firebase initializes automatically

import xyz.useclippr.sdk.Clippr

class MyApp : Application() {
override fun onCreate() {
    super.onCreate()
    Clippr.initialize(this, "YOUR_API_KEY")
}
}

Getting Initial Link

final PendingDynamicLinkData? data =
  await FirebaseDynamicLinks.instance.getInitialLink();
if (data != null) {
final Uri deepLink = data.link;
// Handle link
}

final link = await Clippr.getInitialLink();
if (link != null) {
final path = link.path; // e.g., "/product/123"
// Handle link
}

DynamicLinks.dynamicLinks().handleUniversalLink(url) { link, error in
guard let link = link else { return }
// Handle link
}

if let link = await Clippr.getInitialLink() {
let path = link.path
// Handle link
}

Firebase.dynamicLinks.getDynamicLink(intent)
.addOnSuccessListener { pendingData ->
    val deepLink = pendingData?.link
    // Handle link
}

val link = Clippr.getInitialLink()
if (link != null) {
val path = link.path
// Handle link
}

Listening for Links

FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
final Uri deepLink = dynamicLinkData.link;
});

Clippr.onLink = (link) {
final path = link.path;
};

Clippr.onLink = { link in
let path = link.path
}

Clippr.onLink = { link ->
val path = link.path
}

Creating Links

final dynamicLinkParams = DynamicLinkParameters(
link: Uri.parse('https://example.com/product/123'),
uriPrefix: 'https://example.page.link',
androidParameters: AndroidParameters(packageName: 'com.example.app'),
iosParameters: IOSParameters(bundleId: 'com.example.app'),
);
final link = await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

final params = LinkParameters(
path: '/product/123',
campaign: 'my_campaign',
);
final shortLink = await Clippr.createLink(params);
// shortLink.url contains the short URL

Step 4: Update Platform Configuration

iOS - Associated Domains

Before:

applinks:example.page.link

After:

applinks:yourapp.clppr.xyz

Android - Intent Filter

Before:

<data android:host="example.page.link" android:scheme="https"/>

After:

<data android:host="yourapp.clppr.xyz" android:scheme="https"/>

Step 5: Migrate Links

Option A: Recreate Links

For most cases, recreate your links in Clippr:

1. Export your Firebase links
2. Create equivalent links in Clippr dashboard
3. Update any hardcoded links in marketing materials

Option B: Redirect Old Links

If you have many links in circulation:

1. Set up a redirect from your Firebase domain
2. Redirect to equivalent Clippr links
3. Gradually phase out old links

Step 6: Testing

1. Test direct links: Click link with app installed
2. Test deferred links: Uninstall, click link, install, open
3. Test attribution: Verify campaign/source/medium data
4. Test all platforms: iOS, Android, web fallback

API Comparison Table

Data Model Changes

Firebase PendingDynamicLinkData

// Firebase
data.link              // Full URI
data.utmParameters     // Map

Clippr ClipprLink

// Clippr
link.path              // String path
link.attribution       // campaign, source, medium
link.metadata          // Custom data
link.matchType         // How it was matched

Timeline

1. Now: Start migration, run both in parallel
2. Before Aug 2025: Complete migration
3. Aug 25, 2025: Firebase Dynamic Links shuts down

Need Help?

• Clippr Documentation
• GitHub Issues
• FAQ