A React Native utility for listening to incoming SMS messages on Android devices.
react-native-android-sms-listener is a React Native module that allows Android applications to listen for incoming SMS messages. It solves the problem of accessing SMS content programmatically, enabling features like automatic phone number verification by reading verification codes from SMS. The module provides a simple JavaScript interface to receive parsed SMS data including sender, message body, and timestamp.
React Native developers building Android applications that require SMS interaction, particularly those implementing phone verification systems, messaging features, or SMS-based automation.
Developers choose this module because it offers a straightforward, well-documented solution specifically for SMS listening on Android within React Native, avoiding the need to build native bridging code themselves. Its focus on verification use cases and clean API makes it ideal for implementing WhatsApp/Telegram-style verification flows.
Allows you to listen for incoming SMS messages using React Native
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Offers a straightforward API with just addListener and subscription removal, making integration simple for basic SMS listening, as shown in the concise example code.
Includes ready-to-use examples for extracting verification codes via regex, streamlining implementation of WhatsApp-style phone verification flows.
Provides parsed SMS data including originating address, body, and timestamp out of the box, reducing the need for manual parsing in common use cases.
Returns cancellable subscriptions with a remove method, allowing for easy cleanup and preventing memory leaks when listeners are no longer needed.
Exclusively supports Android, making it unsuitable for cross-platform React Native apps without additional iOS modules or custom bridging.
Requires manual Gradle and Java setup steps, as detailed in the README, which can be error-prone compared to auto-linking in newer React Native versions.
Focuses solely on SMS listening with no built-in features for sending messages, filtering SMS, or accessing historical data, limiting advanced use cases.
Developers must handle READ_SMS permission requests manually, adding extra code and complexity, as highlighted in the permission example.