{"id":13776901,"url":"https://github.com/innoveit/react-native-ble-manager","last_synced_at":"2025-05-10T00:51:10.630Z","repository":{"id":37925510,"uuid":"59281618","full_name":"innoveit/react-native-ble-manager","owner":"innoveit","description":"React Native BLE communication module","archived":false,"fork":false,"pushed_at":"2025-04-18T07:35:42.000Z","size":9046,"stargazers_count":2212,"open_issues_count":25,"forks_count":783,"subscribers_count":46,"default_branch":"master","last_synced_at":"2025-05-01T03:17:41.133Z","etag":null,"topics":["android","ble","bluetooth-low-energy","ios","react-native"],"latest_commit_sha":null,"homepage":"http://innoveit.github.io/react-native-ble-manager/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/innoveit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["marcosinigaglia"]}},"created_at":"2016-05-20T09:20:14.000Z","updated_at":"2025-04-30T19:51:19.000Z","dependencies_parsed_at":"2022-07-11T05:31:55.087Z","dependency_job_id":"730cc42c-edda-41f2-9df7-0c85ef3622f5","html_url":"https://github.com/innoveit/react-native-ble-manager","commit_stats":{"total_commits":879,"total_committers":150,"mean_commits":5.86,"dds":0.4732650739476678,"last_synced_commit":"dad8d3384ee31264195fead54e1ade0d6bf1a002"},"previous_names":[],"tags_count":150,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/innoveit%2Freact-native-ble-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/innoveit%2Freact-native-ble-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/innoveit%2Freact-native-ble-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/innoveit%2Freact-native-ble-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/innoveit","download_url":"https://codeload.github.com/innoveit/react-native-ble-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252963406,"owners_count":21832498,"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","ble","bluetooth-low-energy","ios","react-native"],"created_at":"2024-08-03T18:00:34.657Z","updated_at":"2025-05-07T22:25:29.033Z","avatar_url":"https://github.com/innoveit.png","language":"Java","funding_links":["https://github.com/sponsors/marcosinigaglia"],"categories":["\u003ca name=\"Network:-Native-Modules\"\u003eNetwork: Native Modules\u003c/a\u003e","Java"],"sub_categories":[],"readme":"# react-native-ble-manager\n\n![GitHub Release](https://img.shields.io/github/v/release/innoveit/react-native-ble-manager?style=for-the-badge)\n[![npm version](https://img.shields.io/npm/v/react-native-ble-manager.svg?style=for-the-badge)](https://www.npmjs.com/package/react-native-ble-manager)\n[![npm downloads](https://img.shields.io/npm/dm/react-native-ble-manager.svg?style=for-the-badge)](https://www.npmjs.com/package/react-native-ble-manager)\n[![GitHub issues](https://img.shields.io/github/issues/innoveit/react-native-ble-manager.svg?style=for-the-badge)](https://github.com/innoveit/react-native-ble-manager/issues)\n\nA React Native Bluetooth Low Energy library.\n\nOriginally inspired by https://github.com/don/cordova-plugin-ble-central.\n\n## Introduction\n\nThe library is a simple connection with the OS APIs, the BLE stack should be standard but often has different behaviors based on the device used, the operating system and the BLE chip it connects to. Before opening an issue verify that the problem is really the library.\n\n## Requirements\n\nRN 0.76+ only the new architecture is supported\n\nRN 0.60-0.75 supported until 11.X  \nRN 0.40-0.59 supported until 6.7.X  \nRN 0.30-0.39 supported until 2.4.3  \n\n## Supported Platforms\n\n- iOS 15.1+\n- Android (API 23+)\n\n## Install\n\n```shell\nnpm i --save react-native-ble-manager\n```\n\nThe library support the react native autolink feature.\n\n## Documentation\n\nRead here [the full documentation](https://innoveit.github.io/react-native-ble-manager/)\n\n\n## Example\n\nThe easiest way to test is simple make your AppRegistry point to our example component, like this:\n\n```javascript\n// in your index.ios.js or index.android.js\nimport React, { Component } from \"react\";\nimport { AppRegistry } from \"react-native\";\nimport App from \"react-native-ble-manager/example/App\"; //\u003c-- simply point to the example js!\n/* \nNote: The react-native-ble-manager/example directory is only included when cloning the repo, the above import will not work \nif trying to import react-native-ble-manager/example from node_modules\n*/\nAppRegistry.registerComponent(\"MyAwesomeApp\", () =\u003e App);\n```\n\nOr, [use the example directly](example)\n\n\n## Library development\n\n- the library is written in typescript and needs to be built before being used for publication or local development, using the provided npm scripts in `package.json`.\n- the local `example` project is configured to work with the locally built version of the library. To be able to run it, you need to build at least once the library so that its outputs listed as entrypoint in `package.json` (in the `dist` folder) are properly generated for consumption by the example project:\n\nfrom the root folder:\n\n```shell\nnpm install\nnpm run build\n```\n\n\u003e if you are modifying the typescript files of the library (in `src/`) on the fly, you can run `npm run watch` instead. If you are modifying files from the native counterparts, you'll need to rebuild the whole app for your target environnement (`npm run android/ios`).\n\n### Updating documentation\n\nEdit files in `docs/`, then test locally with:\n```shell\ncd docs\nbundle install\nbundle exec jekyll serve --watch --baseurl /\n```\nThen open http://localhost:4000/ \n\n## Generate the native code from specs\nA react-native project is needed to generate the code via *codegen*.\n\n#### Generate Android code\n- in the example folder generate the android project from expo: `npx expo prebuild --platform android`\n- in the example/android folder run: `./gradlew generateCodegenArtifactsFromSchema` (you can add --info to have debug messages)\n- if you have problems with the gradle cache `cd android \u0026\u0026 ./gradlew --stop \u0026\u0026 rm -rf ~/.gradle/caches`\n\n#### Generate iOS code\n- in the example folder generate the ios project from expo: `npx expo prebuild --platform ios`\n- the codegen run during the first build, if you need to run it again use `pod install` in the ios folder\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finnoveit%2Freact-native-ble-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finnoveit%2Freact-native-ble-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finnoveit%2Freact-native-ble-manager/lists"}