{"id":27634795,"url":"https://github.com/maniac-tech/react-native-expo-read-sms","last_synced_at":"2025-04-23T19:25:53.008Z","repository":{"id":50572969,"uuid":"509797614","full_name":"maniac-tech/react-native-expo-read-sms","owner":"maniac-tech","description":"Library to read incoming SMS in Android for Expo (React Native)","archived":false,"fork":false,"pushed_at":"2025-04-22T17:23:47.000Z","size":1177,"stargazers_count":67,"open_issues_count":13,"forks_count":26,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-23T19:25:30.239Z","etag":null,"topics":["android","android-sms","expo","react-native","read-sms","sms","sms-notification"],"latest_commit_sha":null,"homepage":"https://react-native-expo-read-sms.vercel.app/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maniac-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-02T15:54:12.000Z","updated_at":"2025-04-22T17:23:51.000Z","dependencies_parsed_at":"2024-06-22T23:24:50.066Z","dependency_job_id":"6513685a-e3e0-455c-9f58-0419a5098193","html_url":"https://github.com/maniac-tech/react-native-expo-read-sms","commit_stats":{"total_commits":36,"total_committers":5,"mean_commits":7.2,"dds":0.6388888888888888,"last_synced_commit":"386a03a090dd5c7ea0e6724d77ec388a0dd5990e"},"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maniac-tech%2Freact-native-expo-read-sms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maniac-tech%2Freact-native-expo-read-sms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maniac-tech%2Freact-native-expo-read-sms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maniac-tech%2Freact-native-expo-read-sms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maniac-tech","download_url":"https://codeload.github.com/maniac-tech/react-native-expo-read-sms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250498386,"owners_count":21440456,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-sms","expo","react-native","read-sms","sms","sms-notification"],"created_at":"2025-04-23T19:25:52.233Z","updated_at":"2025-04-23T19:25:52.990Z","avatar_url":"https://github.com/maniac-tech.png","language":"Java","funding_links":["https://buymeacoffee.com/maniac_tech"],"categories":[],"sub_categories":[],"readme":"\n\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://maniac-tech.com/expo-read-sms/\" alt=\"Markdownify\" width=\"200\"\u003e\n    \u003cimg src=\"https://maniac-tech.com/images/expo-read-sms.png\" height=\"300px\"\u003e\n  \u003c/a\u003e\n  \u003cbr\u003e\n  react-native-expo-read-sms\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003eReading SMS made simple in \u003ca href=\"https://reactnative.dev/\" target=\"_blank\"\u003eReact Native\u003c/a\u003e on Android\u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://react-native-expo-read-sms.vercel.app/docs/category/getting-started\"\u003eDocumentation\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#example\"\u003eExample\u003c/a\u003e •\n  \u003ca href=\"#methods\"\u003eMethods\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cimg src=\"https://maniac-tech.com/expo-read-sms/static/images/code.png\" height=\"600px\"\u003e\n\n## Installation\n\nInstall this in your managed Expo project by running this command:\n\n`$ npm install @maniac-tech/react-native-expo-read-sms --save`\n\n## Usage\n\n1. Import the startReadSMS function after installation\n\n\t`import { startReadSMS } from \"@maniac-tech/react-native-expo-read-sms\";`\n\n2. Pass Success and Error callbacks\n\t`startReadSMS(successCallbackFn, errorCallbackFn)`\n\n3. Everytime an SMS has been received `successCallbackFn` will be called with the sms\n\n## Example\n\nYou may refer to this sample application for how to use the library: [GitHub Repo](https://github.com/maniac-tech/ExpoReadSMS-TestApp)\n\n## Methods\n| Method name | Description | Params | Returns |\n|-------------|-------------|--------|---------|\n| `checkIfHasSMSPermission` | Function which checks if the application has `READ_SMS` and `RECEIVE_SMS` permissions | - | ```{ hasReceiveSmsPermission: true/false, hasReadSmsPermission: true/false }``` |\n| `requestReadSMSPermission` | Requests `READ_SMS` and `RECEIVE_SMS` permission, if missing | - | Returns `true` if granted, and `false` otherwise |\n| `startReadSMS` | Starts listening for incoming messages. Note: SMS Permissions should be present. | callback fn | Return a string with message orginating address, and message body. Example: `[+919999999999, this is a sample message body]` |\n\n\n### Important Note:\nEnsure your app has `READ_SMS`, and `RECEIVE_SMS`, failing which you'll receive error on calling the function\n\n## Support\nTested on Expo SDK v44, v45 \u0026 v47, v48, v49, v50 and Node JS v18\n\n## License\nMIT\n\n## Maintainers\n[maniac-tech](https://github.com/maniac-tech/) Active maintainer\n\n\u003ca href=\"https://buymeacoffee.com/maniac_tech\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/purple_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\n## Credits\n\n- [Docusaurus](https://docusaurus.io/): For helping spin up and manitain the documentation with ease.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaniac-tech%2Freact-native-expo-read-sms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaniac-tech%2Freact-native-expo-read-sms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaniac-tech%2Freact-native-expo-read-sms/lists"}