Connect over Bluetooth
Find nearby devices and exchange data with them over Bluetooth Low Energy from a Bare app, on iOS, Android, macOS and Linux, with no network in between.
These guides show how to talk to devices in the same room over Bluetooth Low Energy with bare-bluetooth: no Wi-Fi, no internet, no server. Each guide builds on code that already ships upstream, so you can run it as-is before you change it.
For how the pieces fit together, read Bluetooth in Bare first. For the rules that make your code reliable on real devices, read Bluetooth best practices.
Build a Bluetooth chat for iOS and Android
Walk through the Bluetooth chat in bare-mobile-doctor: two phones find each other, open an L2CAP channel and exchange messages, from a React Native app with a Bare worklet.
Set up Bluetooth in a mobile app
Declare and request the iOS and Android Bluetooth permissions, link the native addons, and start the worklet only once access is granted.
Exchange data over L2CAP
Open a stream between two devices with an L2CAP channel, and hand the channel's PSM to the other side through a characteristic.
Read, write and subscribe with GATT
Scan for a service, connect, find a characteristic and trade writes for notifications.
Use platform-specific Bluetooth features
Drop down to bare-bluetooth-apple or bare-bluetooth-android for what the cross-platform API leaves out, such as reconnecting without a scan.
Last updated on