@truly-you/react-native-sdk

React Native SDK for Truly You authentication with passkeys and NFC passport reading.

Installation

npm install @truly-you/react-native-sdk

The SDK will automatically configure your project for NFC passport reading during installation.

Peer Dependencies

npm install @react-native-async-storage/async-storage react-native-config react-native-passkey

iOS Setup (Automatic)

The SDK automatically:

• ✅ Configures Info.plist with NFC permissions
• ✅ Updates Podfile with iOS 15.0 deployment target
• ✅ Adds NFC entitlements
• ✅ Installs NFCPassportReader via CocoaPods

One manual step required:

1. Open your project in Xcode
2. Go to: Target → Signing & Capabilities
3. Click "+ Capability" and add "Near Field Communication Tag Reading"
4. Run: cd ios && pod install
5. Rebuild your app

Android Setup (Automatic)

Android is fully configured automatically:

• ✅ NFC permissions are merged via autolinking
• ✅ Dependencies (JMRTD, Scuba) are included
• ✅ No manual steps required

If you need to manually run setup:

npx @truly-you/react-native-sdk scripts/setup.js

Usage

import { TrulyYouReactNativeSDK } from '@truly-you/react-native-sdk'

// Initialize SDK
const sdk = new TrulyYouReactNativeSDK({
  apiUrl: 'https://api.dev.ng.truly.you',
  authAppId: 'your-auth-app-id',
  keyId: 'user-key-id'
})

// Start enrollment
await sdk.startEnrollment()

// Fetch with signature
const result = await sdk.fetchWithSignature('https://your-api.com/endpoint', {
  method: 'POST',
  body: JSON.stringify({ data: 'example' })
})

Configuration

The SDK automatically fetches configuration from the backend, including:

• SDK Frontend URL
• Deep link scheme for enrollment callbacks

You only need to provide:

• apiUrl: Your SDK backend URL
• authAppId: Your authentication app ID
• keyId: The passkey ID stored on the device

License

MIT