Setup on Expo

This guide sets up the JavaScript SDK in an Expo app. These steps configure the native modules and polyfills the SDK needs for cross-platform compatibility.

Before you start: an Expo app and a Dynamic environment ID from the Dynamic dashboard. For a bare React Native app, use Setup on Bare React Native instead.

Expo Go is not supported. The SDK depends on native modules that are linked only when you build the native app with npx expo prebuild. Use a development build or EAS Build.

Install dependencies

Install the core packages

Install the SDK packages and their peer dependencies.

npx expo install \
  @dynamic-labs-sdk/client \
  @dynamic-labs-sdk/react-hooks \
  @tanstack/react-query \
  @react-native-async-storage/async-storage \
  react-native-keychain \
  expo-linking

Install the polyfills

Install the polyfills required for secure operations.

npx expo install \
  expo-crypto \
  buffer

You may already have some of these polyfills installed. Install only the ones your project is missing.

Feature packages

The packages above cover email, wallet, and session basics. Each feature below needs an extra package — install it only when you use that feature, then follow its guide.

Feature	Install	Guide
Social / OAuth login	`react-native-inappbrowser-reborn`	Social login
WalletConnect	`@walletconnect/react-native-compat`	WalletConnect integration
Passkeys	`react-native-passkey`	React Native Passkeys
EVM / Solana chains	`@dynamic-labs-sdk/evm`, `@dynamic-labs-sdk/solana`	Add the EVM extension
Export embedded wallet key	`@dynamic-labs-sdk/react-native-embedded-wallet-export`, `react-native-webview`	Export WaaS private key

Create a polyfills file

Create a polyfills.ts file at the root of your project. It shims the Buffer implementation and the Crypto API that secure operations rely on.

polyfills.ts

import { Buffer } from 'buffer';
import { getRandomValues, randomUUID } from 'expo-crypto';

/**
 * Base polyfill for crypto.
 */
if (!global.crypto) {
  // @ts-expect-error — partial Crypto implementation
  global.crypto = {};
}
if (!global.crypto.getRandomValues) {
  // @ts-expect-error — partial Crypto implementation
  global.crypto.getRandomValues = getRandomValues;
}
if (!global.crypto.randomUUID) {
  // @ts-expect-error — partial Crypto implementation
  global.crypto.randomUUID = randomUUID;
}

/**
 * Buffer polyfill for Solana and various cryptographic operations.
 */
global.Buffer = Buffer;

Using WalletConnect? Install @walletconnect/react-native-compat and add import '@walletconnect/react-native-compat'; as the first import in polyfills.ts, above the crypto shims — the WalletConnect relay client requires it to load before anything WalletConnect-related. See WalletConnect integration.

Configure a custom entry point

To guarantee the polyfills run before any other code, add a custom entry point.

Create index.ts

Create an index.ts file at the root of your project:

index.ts

// Polyfills must run before any other import
import './polyfills';
import 'expo-router/entry';

Point package.json to it

Update the main field in package.json:

package.json

{
  "main": "./index.ts"
}

Rebuild the native app

After adding native modules such as expo-crypto, rebuild your development build so the native code is linked.

# Clean and prebuild native directories
npx expo prebuild --clean

# Run on your preferred platform
npx expo run:ios
npx expo run:android

Initialize the Dynamic client

Create a dynamicClient.ts file in your project root or a shared configuration folder. This client is your primary interface to the SDK.

dynamicClient.ts

import { createDynamicClient } from '@dynamic-labs-sdk/client';

export const dynamicClient = createDynamicClient({
  environmentId: 'YOUR_ENVIRONMENT_ID', // Found in your Dynamic dashboard
  /* Additional configuration options */
});

For a full reference of the options, see Creating a Dynamic Client and Initializing the Dynamic Client.

Next steps

Your Expo app is set up. From here, wrap your app in the React hooks provider, add the chains you support, and the rest of your integration works the same as on the web — the guides below apply unchanged unless they show an Expo tab.

Set up the React hooks

Wrap your app in QueryClientProvider and DynamicProvider to use the hooks.

Add the EVM extension

WalletConnect integration

Connect external wallets over WalletConnect — see the Expo tab for deep linking.

Authenticate with email

Send an email OTP and verify the user.

Build a wallet picker

List wallet providers and connect a wallet.

Running into issues? See Troubleshooting in the Overview docs.

Installation & Configuration

React Native

Building UI

Chains & Networks

Authenticate

User & Session Management

Wallets

Flow

Swaps

Funding & Onramp

Events

Install dependencies

Feature packages

Create a polyfills file

Configure a custom entry point

Rebuild the native app

Initialize the Dynamic client

Next steps

Set up the React hooks

Add the EVM extension

WalletConnect integration

Authenticate with email

Build a wallet picker

​Install dependencies

​Feature packages

​Create a polyfills file

​Configure a custom entry point

​Rebuild the native app

​Initialize the Dynamic client

​Next steps

Set up the React hooks

Add the EVM extension

WalletConnect integration

Authenticate with email

Build a wallet picker

Install dependencies

Feature packages

Create a polyfills file

Configure a custom entry point

Rebuild the native app

Initialize the Dynamic client

Next steps