react-native-touch-id
React Native library for biometric authentication (Touch ID and Face ID) on iOS and Android.
What is react-native-touch-id?
React Native Touch ID is a library that enables React Native mobile applications to authenticate users using the device's built-in biometric sensors. It provides a JavaScript interface to iOS and Android biometric APIs, allowing developers to add Touch ID (fingerprint) and Face ID (facial recognition) authentication to their apps. The library handles the native authentication popups and error scenarios, simplifying secure user verification.
React Native developers building iOS and Android applications that require secure, user-friendly authentication methods. It's particularly useful for apps handling sensitive data, financial transactions, or any scenario where biometric login enhances security and convenience.
Developers choose React Native Touch ID because it offers a straightforward, cross-platform API for biometric authentication without needing to write native code. It provides consistent error handling, platform-specific customization, and uses the native system UI for authentication, ensuring a familiar experience for users.
Overview
React Native authentication with the native Touch ID popup.
Use Cases
Best For
- Adding fingerprint login to React Native banking or finance apps
- Implementing Face ID authentication for healthcare applications
- Securing sensitive data access in enterprise React Native apps
- Replacing password entry with biometric authentication in mobile apps
- Creating seamless login experiences for React Native e-commerce applications
- Building password managers or secure note apps with biometric protection
Not Ideal For
- Projects requiring actively maintained dependencies with long-term support
- Android-first applications where stable, fully-featured biometric APIs are critical
- Teams using Expo or preferring integrated solutions like expo-local-authentication
- Applications needing modern biometric features such as Android's BiometricPrompt with encryption support
Pros & Cons
Pros
Offers a unified JavaScript API for both iOS and Android biometric authentication, simplifying development with methods like `authenticate` and `isSupported` that handle platform differences internally.
Leverages the device's native authentication dialogs (e.g., iOS Face ID popup, Android fingerprint UI) for a secure and familiar user experience, as emphasized in the library's philosophy.
Provides comprehensive error codes for various failure scenarios, such as 'NOT_ENROLLED' or 'AUTHENTICATION_FAILED', which are documented in the README to aid in debugging and user feedback.
Allows customization of dialog text, colors on Android, and fallback options like passcode entry on iOS, via a config object in the `authenticate` method.
Cons
The README explicitly states the library is 'not currently actively maintained,' increasing the risk of bugs, security vulnerabilities, and incompatibility with newer React Native versions.
Android functionality is labeled as experimental in the description, leading to potential instability, limited features, and poorer error handling compared to iOS.
Requires manual linking steps like `react-native link` or editing native files (e.g., AndroidManifest.xml, Info.plist), adding complexity and setup time compared to pure JavaScript solutions.
Frequently Asked Questions
Related Projects
React Native Firebase🔥 A well-tested feature-rich modular Firebase implementation for React Native. Supports both iOS & Android platforms for all Firebase services.
react-native-push-notificationReact Native Local and Remote Notifications
react-native-device-infoDevice Information for React Native iOS and Android
react-native-fsNative filesystem access for react-native
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.