react-native-firebase/docs/dynamic-links/quick-start.md

title, description

title	description
Quick Start	Getting started with Dynamic Links in React Native Firebase

Dynamic Links Quick Start

Installation

This module depends on the @react-native-firebase/app module. To get started and install app, visit the project's quick start guide.

Install this module with Yarn:

yarn add @react-native-firebase/dynamic-links

# Using iOS
cd ios/ && pod install

Integrating manually and not via React Native auto-linking? Check the setup instructions for Android & iOS.

Module usage

Import the Dynamic Links package into your project:

import dynamicLinks from '@react-native-firebase/dynamic-links';

The package also provides access to the firebase instance:

import { firebase } from '@react-native-firebase/dynamic-links';

Using links

Links can be created with analytics attached to them.

import dynamicLinks from '@react-native-firebase/dynamic-links';

const link = await dynamicLinks().buildLink({
  link: 'https://invertase.io',
  domainUriPrefix: 'https://xyz.page.link',
  analytics: {
    campaign: 'banner',
  },
});

And you can setup your app to handle dynamic links opened from anywhere.

function App() {
  const handleDynamicLink = link => {
    // Handle dynamic link inside your own application
    if (link.url === 'https://invertase.io/offer') return navigateTo('/offers');
  };

  useEffect(() => {
    const unsubscribe = firebase.dynamicLinks().onLink(handleDynamicLink);
    // When the component unmounts, remove the listener
    return unsubscribe;
  }, []);

  return <YourApp />;
}

Link persistence

When your app was launched (or even installed first) as a result of following a dynamic link, the initial link is still available.

import dynamicLinks from '@react-native-firebase/dynamic-links';

async function bootstrapApp() {
   const initialLink = await dynamicLinks().getInitialLink();

   if (initialLink) {
     if (initialLink.url === 'https://invertase.io/offer') return navigateTo('/offers')
   }
}