Install & 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.
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
Then install the resulting development build on your device or simulator. If you’re using a bare React Native project, install the native dependencies:cd ios && pod install && cd ..
Then rebuild your app using Xcode or npx react-native run-ios / npx react-native run-android.
Polyfills
Please refer to the Polyfills section for information on how to set up necessary polyfills.
Setup Deeplink URLs
To use most React Native features (such as social connections), set up the mobile deeplink URLs Dynamic uses to redirect back to your app.
For step-by-step setup, see Deeplink URLs.