Firebase Migration Guide

Complete step-by-step guide to migrate from Firebase Dynamic Links to Redirectly with zero downtime and minimal code changes.

Migration Summary

Most migrations take less than 30 minutes. No app store updates required. Your existing links continue working.

1

Create Redirectly Account

Sign up for Redirectly and set up your custom subdomain to match your Firebase setup.

Action Items:

  • • Sign up at redirectly.app
  • • Choose your subdomain (e.g., yourapp.redirectly.app)
  • • Generate your API key from the dashboard
2

Configure Mobile Apps

Set up your iOS and Android app configurations for deep linking.

iOS Configuration

  • • Bundle ID: com.yourapp.example
  • • App Store ID: 123456789
  • • Team ID: ABC123DEF4

Android Configuration

  • • Package Name: com.yourapp.example
  • • SHA256 Fingerprint: AA:BB:CC...
  • • Play Store URL: play.google.com/store/apps/details?id=com.yourapp.example
3

Update Your Code

Replace Firebase Dynamic Links code with Redirectly API calls.

Flutter/Dart

Before (Firebase)
final dynamicLink = await FirebaseDynamicLinks.instance.buildLink(
  DynamicLinkParameters(
    uriPrefix: 'https://yourapp.page.link',
    link: Uri.parse('https://example.com/item/123'),
    androidParameters: AndroidParameters(
      packageName: 'com.example.app',
    ),
    iosParameters: IOSParameters(
      bundleId: 'com.example.app',
    ),
  ),
);
After (Redirectly)
import 'package:flutter_redirectly/flutter_redirectly.dart';

final redirectly = FlutterRedirectly();
await redirectly.initialize(RedirectlyConfig(
  apiKey: 'your-api-key',
  baseUrl: 'https://redirectly.app',
));

final link = await redirectly.createLink(
  slug: 'item-123',
  target: 'https://example.com/item/123',
);
4

Test Your Integration

Verify that your integration works correctly before going live.

Testing Checklist

Links are created successfully
Deep linking works on iOS
Deep linking works on Android
Analytics are being tracked
5

Go Live

Deploy your changes and start using Redirectly in production.

Migration Tip

Your existing Firebase Dynamic Links will continue to work even after migration. You can migrate gradually by using Redirectly for new links only.

Common Migration Issues

Deep links not opening the app

Make sure your mobile app configurations match exactly with what you had in Firebase.

Get help with configuration

API authentication errors

Verify that your API key is correct and has the necessary permissions.

Check API documentation

Need Help with Migration?

Our team can help you migrate with zero downtime. We offer free migration assistance for all new customers.