# Background Geolocation for Capacitor []() []() 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 **`v9`**. For the previous version see [`v8.x`](https://github.com/transistorsoft/capacitor-background-geolocation/tree/8.0.1). **`v8.x`** license keys do **not** work with **`v9`** — log in to the [Customer Dashboard](https://transistorsoft.com) to generate a **`v9`** key. See the [Migration Guide](help/MIGRATION-GUIDE-9.0.0.md) for details. --- ## :books: Documentation ### Capacitor - [Setup](https://docs.transistorsoft.com/capacitor/setup/) - [API Reference](https://docs.transistorsoft.com/capacitor/BackgroundGeolocation/) - [Example](https://docs.transistorsoft.com/capacitor/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 Two example apps are included in the [`example/`](./example) directory: | App | Description | |-----|-------------| | [`example/basic`](./example/basic) | Minimal getting-started app — configure, toggle tracking, view events. Start here. | | [`example/advanced`](./example/advanced) | Full-featured reference app with live map, geofence tools, all settings, and Transistor server integration. | See the [example README](./example/README.md) for setup instructions. --- ## 📦 SDK availability | Platform | Package | |---|---| | Capacitor | **This repo** | | [React Native](https://github.com/transistorsoft/react-native-background-geolocation) | `react-native-background-geolocation` | | [Expo](https://github.com/transistorsoft/react-native-background-geolocation) | `react-native-background-geolocation` | | [Flutter](https://github.com/transistorsoft/flutter_background_geolocation) | `flutter_background_geolocation` | | [Cordova](https://github.com/transistorsoft/cordova-background-geolocation-lt) | `cordova-background-geolocation-lt` | | [Swift / iOS](https://github.com/transistorsoft/background-geolocation) | `background-geolocation` | | [Kotlin / Android](https://github.com/transistorsoft/background-geolocation) | `background-geolocation` | --- MIT © [Transistor Software](https://www.transistorsoft.com)