FacePlugin
Get in Touch
React Native

Face Recognition SDK for React Native

A fully on-device React Native plugin covering face detection, landmarks, recognition, liveness, pose, expression, and attributes — published as the npm package face-recognition-sdk.

Fully on-deviceMIT-licensed pluginnpm package
Woman scanning her face with a phone for 1:1 verification on the React Native SDK
Identity Verified
Face Match 99.98%
Requirements

What You Need to Run It on React Native

These are the exact minimum and recommended requirements published in the FaceRecognition-React-Native repository — check the repo directly for the latest version, since SDK requirements can change between releases.

React Native0.74.x (example app uses 0.74.5)
Node.js18+
AndroidminSdk 24, physical device recommended
iOSiOS 13+ (A12+ recommended), physical device
ExpoExpo Go is not supported (native code) — a development build is required
Quick Start

Install and Activate

Install the SDK, then activate it with a license key before calling any recognition function — every platform follows this same activate-then-initialize pattern.

  • Install the plugin directly from GitHub: yarn add github:Faceplugin-ltd/FaceRecognition-React-Native.
  • Copy facerecognitionsdk.aar into the plugin's android/libs/ folder, and the three required iOS frameworks into its ios/Frameworks/ folder, then run pod install.
  • For the optional built-in capture UI, also install react-native-vision-camera and react-native-svg, and configure camera permissions.
typescript
import { setActivation, init, SDK_SUCCESS } from 'face-recognition-sdk';

const code = await setActivation('FP1....');
if (code === SDK_SUCCESS) {
  await init();
}
// then call faceDetection / templateExtraction / similarity ...
Licensing

How Licensing Works

The React Native plugin is MIT-licensed. The native SDK runtime still requires an offline license key bound to your app ID or bundle ID — the demo app's key only works for its own demo package, so contact FacePlugin for a key for your app.

FAQ

Frequently Asked Questions

Does the React Native SDK send biometric data to the cloud?

No. Every stage of face recognition runs on your own server or directly on the device, depending on the platform – biometric templates never leave an environment you control.

How is the SDK licensed?

Licenses are offline and bound to a machine code, application ID, or bundle ID depending on the platform. Contact FacePlugin with that identifier to receive a license key – there are no per-call or per-match fees once licensed.

Where can I see the full source and open an issue?

The FaceRecognition-React-Native integration is maintained publicly on GitHub at github.com/Faceplugin-ltd, where you can browse the code, file issues, and track releases.

Related

Pairs Well With

Flutter SDK

One plugin for Android and iOS.

Ionic SDK

Capacitor and Cordova builds for Android and iOS.

Face Recognition SDK

The full product overview across every platform.

Ready to Add Face Recognition to Your React Native App?

Talk to our team to get a license key and a 15-day evaluation period started.