https://github.com/smileidentity/react-native-v11
The Official Smile ID React Native SDK
https://github.com/smileidentity/react-native-v11
android ios javascript react-native
Last synced: 5 months ago
JSON representation
The Official Smile ID React Native SDK
- Host: GitHub
- URL: https://github.com/smileidentity/react-native-v11
- Owner: smileidentity
- License: mit
- Created: 2023-08-21T10:02:56.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-23T13:44:14.000Z (6 months ago)
- Last Synced: 2026-01-24T05:36:22.979Z (6 months ago)
- Topics: android, ios, javascript, react-native
- Language: Kotlin
- Homepage: https://docs.smileidentity.com/integration-options/mobile
- Size: 142 MB
- Stars: 2
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS.txt
Awesome Lists containing this project
README
# Smile ID React Native SDK
[](https://github.com/smileidentity/react-native/actions/workflows/ci.yml)
Smile ID provides premier solutions for Real Time Digital KYC, Identity Verification, User Onboarding, and User Authentication across Africa.
If you haven’t already, [sign up](https://www.usesmileid.com/schedule-a-demo/) for a free Smile ID account, which comes with Sandbox access.
Please see [CHANGELOG.md](CHANGELOG.md) or [Releases](https://github.com/smileidentity/react-native/releases) for the most recent version and release notes.
## Getting Started
Full documentation is available at [Smile ID Documentation]((https://docs.usesmileid.com/integration-options/mobile/getting-started))
### 0. Requirements
* Node.js >=16.0
* React Native >=0.70 and <=0.74.2 (Old Architecture only)
* A `smile_config.json` file from [Smile ID Portal](https://portal.usesmileid.com/sdk)
* See: [Android Requirements](https://github.com/smileidentity/android) for Android specific requirements.
* See: [iOS Requirements](https://github.com/smileidentity/ios) for iOS specific requirements.
### 1. Compatibility
This SDK supports React Native versions **0.70 to 0.74.2** on the **Old Architecture** only. Using it on unsupported versions may lead to unexpected issues such as build failures, SmileID components not rendering, or runtime crashes.
If you're using Expo, use the [SmileID Expo SDK](https://github.com/smileidentity/react-native-expo).
For the **New Architecture** or **React Native > 0.74.2**, we don't currently have an official SDK. If you'd like to build your own wrapper around the native SmileID SDKs, check out our [recipes repo](https://github.com/smileidentity/recipes/blob/main/DOCS.md) for guides and a [sample wrapper implementation](https://github.com/smileidentity/recipes/tree/main/rn-wrap) to reference.
### 2. Dependency
The latest release is available on [npm](https://www.npmjs.com/package/rn-smile-id)
Add the dependency to your `package.json`:
```json
{
"dependencies": {
"@smile_identity/react-native": ""
}
}
```
### 3. Initialization
There are multiple ways to initialize the SDK. See [Initialization](https://docs.usesmileid.com/integration-options/mobile/getting-started) and choose the best option
for your integration
## Getting Help
For detailed documentation, please visit [Smile ID Documentation](https://docs.usesmileid.com/integration-options/mobile)
If you require further assistance, you can [file a support ticket](https://portal.usesmileid.com/partner/support/tickets) or [contact us](https://www.usesmileid.com/contact-us/)
## Contributing
Bug reports and Pull Requests are welcomed. Please see [CONTRIBUTING.md](CONTRIBUTING.md)
## License
[MIT License](LICENSE)