Installation

Install the VECU React Native Verifier SDK into your application and configure your host app for device-based flows.

Native Setup Required

If you enable NFC delivery of the verification request via Android HCE, your host app must register a native HCE service and declare the VECU AID in its manifest. Review Permissions before testing on device. Core QR-only verification does not require any native setup.

Prerequisites

  • React Native >= 0.72.0
  • React >= 18.0.0
  • Access to the Cox Automotive package registry

Step 1: Configure Package Access

The SDK is distributed through Cox Automotive's Artifactory registry. Add or update your .npmrc:

registry=https://artifactory.coxautoinc.com/artifactory/api/npm/cai-npm/
//artifactory.coxautoinc.com/artifactory/api/npm/:_auth=YOUR_AUTH_TOKEN
always-auth=true

Step 2: Install the SDK

npm install @vecu/verifier-react-native-sdk react-native-svg react-native-qrcode-svg

react-native-svg and react-native-qrcode-svg are peer dependencies required for QR code rendering.

Step 3: Install iOS Pods

cd ios && pod install

Next Steps

  • Quick Start — Render your first verification flow
  • Permissions — Native NFC, HCE, Bluetooth, and entitlement setup