Getting Started

Installation and Initialization

Getting Started

• React Native 0.70.+

• A smile_config.json file from https://portal.usesmileid.com/sdk

Android

• Minimum SDK version Android 5.0+ (API level 21+)

• Compile SDK 34

• Target SDK 34

• A device with Google Play Services

• Kotlin 1.9.10

• Java 17

iOS

• iOS 13.0+

Getting Started

This SDK is a wrapper around the native Android and iOS SDKs. Please refer to the Android and iOS documentation for more information.

Dependency

The latest release is available on npm

Add the dependency to your package.json

"dependencies" : {
 "@smile_identity/react-native": "<version>"
}

Smile Config

Android

Place the smile_config.json file under your application's assets, located at src/main/assets (This should be at the same level as your java and res directories)

⚠️ Note: You may need to create this directory if it does not already exist

iOS

Drag the smile_config.json file[^1] into your projects file inspector and ensure that the file is added to your app's target. Confirm that it is by checking the Copy Bundle Resources drop down in the Build Phases tab as shown below.

Initialization

Initialize the Smile ID SDK in your app entry point, typically App.tsx by calling initialize

import {SmileID } from '@smile_identity/react-native';

  React.useEffect(() => {
    SmileID.initialize(true); //true if running on sandbox false if running production
  }, []);