SDK Installation (React Native)

Detour provides a React Native SDK (@swmansion/react-native-detour) compatible with Expo and bare React Native projects.

Before installation, make sure your app is created in the Detour Dashboard and you have:

• appID from API configuration
• publishable apiKey from API configuration
• platform integration snippets from App configuration

Install package

NPM

npm install @swmansion/react-native-detour

YARN

yarn add @swmansion/react-native-detour

PNPM

pnpm add @swmansion/react-native-detour

BUN

bun add @swmansion/react-native-detour

Install peer dependencies

NPM

npm install expo-localization react-native-device-info expo-clipboard @react-native-async-storage/async-storage expo-application

YARN

yarn add expo-localization react-native-device-info expo-clipboard @react-native-async-storage/async-storage expo-application

PNPM

pnpm add expo-localization react-native-device-info expo-clipboard @react-native-async-storage/async-storage expo-application

BUN

bun add expo-localization react-native-device-info expo-clipboard @react-native-async-storage/async-storage expo-application

@react-native-async-storage/async-storage is optional if you provide a custom storage adapter in config. See Custom Storage.

After installing react-native-device-info in Expo managed workflow, create a custom development build: https://docs.expo.dev/develop/development-builds/introduction/

Credentials in app config

import { type Config } from '@swmansion/react-native-detour';

export const detourConfig: Config = {
  apiKey: process.env.EXPO_PUBLIC_DETOUR_API_KEY!,
  appID: process.env.EXPO_PUBLIC_DETOUR_APP_ID!,
  shouldUseClipboard: true,
};

Keep apiKey and appID in environment variables or another secure configuration layer.

Next steps

1. Implement the provider and link handling in SDK Usage.
2. Pick a runnable app pattern in Examples.
3. If upgrading existing code, follow Migration to v1.