Does the React Native SDK work with Expo?

Yes. The SDK works with both Expo managed workflow and bare React Native projects. The camera scanner uses expo-camera 15 or later (Expo SDK 51+); the verification client and hook have no Expo dependency.

Which package and imports do I use?

Install @switchlabs/verify-ai-react-native. Import useVerifyAI and VerifyAIClient from the package itself, VerifyAIScanner from @switchlabs/verify-ai-react-native/scanner, and InspectionClient and VerifyAIInspection from @switchlabs/verify-ai-react-native/inspection, so apps that don't use the camera don't pull in its modules.

How large is the SDK?

The React Native SDK adds approximately 5MB to your app bundle. The on-device AI models are downloaded on first use and cached locally.

Can I customize the camera UI?

Yes. VerifyAIScanner takes an overlay prop for instructions, processing, failure and retry copy, theme colors, and a style prop; set showCaptureButton to false and trigger capture through captureRef to use your own button. You can also skip the scanner and call verify() or verifyMultipart() with a photo from your own camera.

Does it support both iOS and Android?

Yes. The SDK provides native performance on both platforms with a single JavaScript API. iOS 14+ and Android API 24+ are supported.

What does a result look like?

verify() resolves to the verification: id, is_compliant, confidence, violation_reasons (an array of failed criterion ids), feedback (a sentence you can show the user), category, metadata and image_url. It returns null when offline mode queued the request instead.

How do I handle offline scenarios?

Pass offlineMode: true and install @react-native-async-storage/async-storage. Network errors, timeouts, 429s and 5xx responses are queued and retried automatically; verify() returns null for a queued request, and queueSize and processQueue() let you show and drive the queue.

VerifyAI React Native SDK

@switchlabs/verify-ai-react-native gives your app a useVerifyAI hook, a drop-in camera scanner with retry guidance, an offline queue, and a guided vehicle inspection screen. Works with Expo and bare React Native.

Try Live Demo Contact Sales

Quick Start

1. Install

bash

npm install @switchlabs/verify-ai-react-native

# For the camera scanner:
npx expo install expo-camera expo-image-manipulator expo-sensors

2. Use

tsx

import { useVerifyAI } from '@switchlabs/verify-ai-react-native';
import { VerifyAIScanner } from '@switchlabs/verify-ai-react-native/scanner';

export function ParkingPhoto({ onDone }: { onDone: () => void }) {
  const { verify } = useVerifyAI({ apiKey: process.env.EXPO_PUBLIC_VERIFY_AI_KEY! });

  return (
    <VerifyAIScanner
      policy="scooter_parking"
      onCapture={(base64) => verify({ image: base64, policy: 'scooter_parking' })}
      onResult={(result) => {
        if (result.is_compliant) onDone();
        else console.log(result.feedback, result.violation_reasons);
      }}
    />
  );
}

Features

Native Camera UI

Pre-built camera overlay with real-time guidance for optimal photo capture. Customizable themes and branding.

On-Device AI

AI processing happens on the user's device. Sub-200ms latency with no cloud round-trips required.

Offline Support

Full verification works without internet. Results queue and sync automatically when connection returns.

TypeScript Support

Full TypeScript definitions included. Autocomplete and type checking for all API methods.

Hooks API

React hooks-based API (useVerifyAI) for clean integration with functional components.

Expo Compatible

Works with both bare React Native and Expo managed workflow projects.

Code Examples

Requirements

React Native 0.72 or higher
Expo SDK 51+ / expo-camera 15+ for the scanner (core client has no Expo dependency)
Camera permission configured in app
VerifyAI API key (free sandbox available)
SDK 2.9.0 or later for guided vehicle inspections

Frequently Asked Questions

Start Building with React Native

Get your free API key and integrate VerifyAI in minutes.