react-native-background-geolocation

# 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 ### 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/) ### 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. > > Need to test a `RELEASE` build? [Generate a free 30-day trial license](https://transistorsoft.com/shop/trials/new). A license is required for **`RELEASE` builds** on both iOS and Android. [Purchase a license](https://docs.transistorsoft.com/purchase/?platform=react-native) --- ## :open_file_folder: Example Apps See [`/example`](example/README.md) — example apps are included in this repo. --- ## SDK availability | Platform | Package | |---|---| | React Native | **This repo** | | Expo | **This repo** | | [Flutter](https://github.com/transistorsoft/flutter_background_geolocation) | `flutter_background_geolocation` | | [Capacitor](https://github.com/transistorsoft/capacitor-background-geolocation) | `@transistorsoft/capacitor-background-geolocation` | | [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt) | `cordova-background-geolocation-lt` | | [Swift / iOS](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` | | [Kotlin / Android](https://github.com/transistorsoft/native-background-geolocation) | `background-geolocation` | --- MIT © [Transistor Software](https://www.transistorsoft.com)