Deeplink URLs

In order to use most of our react native features (such as social connections), you will first have to set up the list of mobile deeplink URLs dynamic may use to redirect back to your app.

For security reasons, when deeplinking back to your app, we must verify whether the app’s deeplink URL is included in this list. If it isn’t, Dynamic will not perform the deeplink.

How to set up your app for deeplinking

Configuring your app’s custom scheme

First, you should follow Expo’s guide on enabling deeplinking for your app here.

Registering your app’s deeplink URL with Dynamic

Afterwards, head to your Dynamic dashboard’s Security page and enable “Whitelist Mobile Deeplink”. Click “Save changes”.

Next, click the cog in this same section to open up the Mobile Deeplink URL page, and there you must add your app’s deeplink URL with the same custom scheme you configured in the previous step. It might look something like this: myappcustomscheme://.

Creating a new app bundle

After configuring the deeplink URL, you need to create a new app bundle that includes the deeplink configuration. This is necessary because the native modules and configurations need to be properly set up in the app bundle.

For Expo projects, you have two options:

1. Use expo prebuild to generate the native code and then build your app
2. Use EAS (Expo Application Services) to build your app bundle

For React Native projects without Expo, you’ll need to rebuild your native app with the updated configuration.

Troubleshooting

You can check if the deeplink is working by:

• installing the app in the simulation
• opening safari
• paste the deeplink they configured in the dashboard
• your app should open as a result of opening the deeplink in safari

If this fails, it means the app bundle does not have the deeplink correctly setup.

To fix it, check the app.json file and look for the schema and slug fields, and make sure you have properly built a new app bundle. Note that you cannot use the EXPO GO app, you have to build the app using expo prebuild or using EAS to build the app bundle for you.