Introduction

2 min read

The Expo SDK, @onefootprint/footprint-expo, runs the Footprint onboarding flow inside your Expo app. It works like the web integration, but opens the flow in an in-app browser (webview) instead of an iframe.

This package cannot run in the Expo Go app because it requires custom native code. Rebuild your app with npx expo prebuild, as described in the Expo guide Adding custom native code.

Minimum version requirements

Check your environment against these versions before installing:

Dependency	Minimum version
Expo	Last 3 major versions

The flow opens in the device browser and does not load on versions older than those listed under Browser support.

Installation

Install @onefootprint/footprint-expo version 3 or higher.

bash
1npm install @onefootprint/footprint-expo

Install the required peer dependencies.

bash
1npm install expo-linking expo-web-browser @fingerprintjs/fingerprintjs-pro-react-native

On iOS, install the pods.

bash
1npx pod-install

On Android, add the Fingerprint Pro Maven repository to the allprojects block in android/build.gradle.

groovy
1allprojects {
2    repositories {
3        google()
4        mavenCentral()
5        maven { url 'https://www.jitpack.io' }
6        maven { url 'https://maven.fpregistry.io/releases' }
7    }
8}

@fingerprintjs/fingerprintjs-pro-react-native hosts its Android SDK on a custom Maven repository. Without this repository, the Android build fails with dependency resolution errors.

Next steps

Onboarding (KYC/KYB) starts an onboarding from your app and handles the validation token it returns.
WebView integration renders the flow in a native sheet you control instead of an in-app browser.