react-native-background-geolocation
<p align="center"> <img src="https://raw.githubusercontent.com/transistorsoft/assets/master/images/logos/transistor/transistor-logo-panel-react-native.svg" alt="Background Geolocation for React Native" width="635"> </p> # Background Geolocation for React Native & Expo []() []() The most sophisticated background **location-tracking & geofencing** SDK with battery-conscious motion-detection intelligence for **iOS** and **Android**. The SDK uses **motion-detection** APIs (accelerometer, gyroscope, magnetometer) to detect when the device is *moving* or *stationary*: - **Moving** — location recording starts automatically at the configured `distanceFilter` (metres) - **Stationary** — location services turn off automatically to conserve battery > [!IMPORTANT] > This is **`v5`**. For the previous version see [`v4.x`](https://github.com/transistorsoft/react-native-background-geolocation/tree/4.19.4). **`v4.x`** license keys do **not** work with **`v5`** — log in to the [Customer Dashboard](https://transistorsoft.com) to generate a **`v5`** key. See the [Migration Guide](help/MIGRATION-GUIDE-5.0.0.md) for details. --- ## :books: Documentation ### <img src="assets/images/platforms/react-native.svg" width="20" height="20"> React Native - [Setup](https://docs.transistorsoft.com/react-native/setup/) - [API Reference](https://docs.transistorsoft.com/react-native/BackgroundGeolocation/) - [Example](https://docs.transistorsoft.com/react-native/examples/) ### <img src="assets/images/platforms/expo.svg" width="20" height="20"> Expo - [Setup](https://docs.transistorsoft.com/react-native/setup/) - [API Reference](https://docs.transistorsoft.com/react-native/BackgroundGeolocation/) - [Example](https://docs.transistorsoft.com/react-native/examples/) --- ## :key: Licensing > [!TIP] > The SDK is **fully functional in `DEBUG` builds** — no license required. Try before you buy. A license is required only for **`RELEASE` builds** on Android. [Purchase a license](https://docs.transistorsoft.com) --- ## :open_file_folder: Example Apps See [`/example`](example/README.md) — example apps are included in this repo. --- ## 📦 SDK availability | Platform | Package | |---|---| | <img src="assets/images/platforms/react-native.svg" width="16" height="16"> React Native | **This repo** | | <img src="assets/images/platforms/expo.svg" width="16" height="16"> Expo | **This repo** | | <img src="assets/images/platforms/flutter.svg" width="16" height="16"> [Flutter](https://github.com/transistorsoft/flutter_background_geolocation) | `flutter_background_geolocation` | | <img src="assets/images/platforms/capacitor.svg" width="16" height="16"> [Capacitor](https://github.com/transistorsoft/capacitor-background-geolocation) | `@transistorsoft/capacitor-background-geolocation` | | <img src="assets/images/platforms/cordova.svg" width="16" height="16"> [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt) | `cordova-background-geolocation-lt` | | <img src="assets/images/platforms/swift.svg" width="16" height="16"> [Swift / iOS](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` | | <img src="assets/images/platforms/kotlin.svg" width="16" height="16"> [Kotlin / Android](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` | --- MIT © [Transistor Software](https://www.transistorsoft.com)