React Native Quickstart

Prerequisite: If you use AI-assisted development, complete Developing with AI first.

Install the SDK

Prebuild (Expo) / Native linking

Since our SDK relies on native modules (e.g. react-native-webview, expo-secure-store), you need to rebuild the native layer of your app after installing.

This SDK is not compatible with Expo Go. Expo Go does not support custom native modules. You must use a development build, EAS Build, or a bare React Native workflow.

Expo (managed)

If you’re using Expo with a managed workflow, run:

Shell

npx expo prebuild

Then rebuild your app with npx expo run:ios or npx expo run:android.

EAS Build

If you’re using EAS Build, the native modules will be linked automatically during the cloud build. Simply run:

Shell

eas build --profile <your-profile> --platform all

Then install the resulting development build on your device or simulator.

Bare React Native

If you’re using a bare React Native project, install the native dependencies:

Shell

cd ios && pod install && cd ..

Then rebuild your app using Xcode or npx react-native run-ios / npx react-native run-android.

Initialize the SDK

Use the client and its modules; use useReactiveClient from @dynamic-labs/react-hooks when you need reactive state in components.

appOrigin is a mandatory field in the Dynamic config. Make sure to set it to your app’s origin URL when initializing the SDK.

Polyfills

Please refer to the Polyfills section for information on how to set up necessary polyfills.

Setup Deeplink URLs

In order to use most of the 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 detailed instructions on configuring deeplinks, please refer to our Deeplink URLs guide.