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)
EAS Build
Bare React Native
If you’re using Expo with a managed workflow, run:Then rebuild your app with npx expo run:ios or npx expo run:android. If you’re using EAS Build, the native modules will be linked automatically during the cloud build. Simply run:eas build --profile <your-profile> --platform all
If you’re using a bare React Native project, install the native dependencies:cd ios && pod install && cd ..
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. 
