Installation

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

Device info provider

react-native-device-info is a required peer dependency. Unlike storage, the device info source is not configurable. The SDK imports the library directly to read the device model, manufacturer, OS version, and user agent for the deferred-link fingerprint. There is no adapter to plug in.

Custom storage

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

Expo managed workflow

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 Usage.
2. Pick a runnable app pattern in Examples.
3. If upgrading existing code, follow Migration to v1.