hub / github.com/transistorsoft/react-native-background-geolocation
github.com/transistorsoft/react-native-background-geolocation @5.1.1
Chat with this repo
612 symbols
1,360 edges
93 files
123 documented · 20%
10 cross-repo links
● updated 2d ago★ 2,90930 open issues
Browse by type
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
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 seev4.x.v4.xlicense keys do not work withv5— log in to the Customer Dashboard to generate av5key. See the Migration Guide for details.
:books: Documentation
React Native
Expo
:key: Licensing
[!TIP] The SDK is fully functional in
DEBUGbuilds — no license required. Try before you buy.
A license is required only for RELEASE builds on Android.
Purchase a license
:open_file_folder: Example Apps
See /example — example apps are included in this repo.
📦 SDK availability
| Platform | Package |
|---|---|
| React Native |
This repo |
| Expo |
This repo |
 Flutter |
flutter_background_geolocation |
 Capacitor |
@transistorsoft/capacitor-background-geolocation |
 Cordova |
cordova-background-geolocation-lt |
 Swift / iOS |
background-geolocation |
 Kotlin / Android |
background-geolocation |
MIT © Transistor Software
Extension points exported contracts — how you extend this code
OnErrorCallback (Interface)
(no doc) [4 implementers]
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTaskManager.java
Logger (Interface)
* # Logger API * * The Background Geolocation SDK includes powerful logging features for debugging location-tracking [1 …
src/declarations/interfaces/Logger.d.ts
Spec (Interface)
(no doc) [1 implementers]
src/specs/NativeRNBackgroundGeolocation.js
Spec (Interface)
(no doc) [1 implementers]
src/native/specs/NativeBackgroundGeolocation.ts
TSMapViewProps (Interface)
(no doc)
example/Advanced/src/TSMapView.tsx
OnFinishCallback (Interface)
(no doc) [1 implementers]
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTaskManager.java
DeviceSettings (Interface)
* Device Settings API. * * Provides an API to show Android & vendor-specific Battery / Power Management settings scree [1 …
src/declarations/interfaces/DeviceSettings.d.ts
Props (Interface)
(no doc)
example/Advanced/src/AddGeofenceTypeSheet.tsx
Core symbols most depended-on inside this repo
log
called by 82
src/native/specs/NativeBackgroundGeolocation.ts
warn
called by 47
src/declarations/interfaces/Logger.d.ts
getAdapter
called by 40
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/RNBackgroundGeolocationModule.java
mapToWritableMap
called by 19
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/RNBackgroundGeolocationModule.java
remove
called by 19
src/declarations/interfaces/Subscription.d.ts
getInstance
called by 18
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTaskManager.java
sendEvent
called by 16
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/RNBackgroundGeolocationModule.java
addListener
called by 14
src/index.js
Shape
Languages
TypeScript72%
Java28%
Modules by API surface
src/index.js139 symbols
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/RNBackgroundGeolocationModule.java116 symbols
src/NativeModule.js59 symbols
android/src/main/java/com/transistorsoft/rnbackgroundgeolocation/HeadlessTaskManager.java48 symbols
src/native/specs/NativeBackgroundGeolocation.ts31 symbols
example/Advanced/src/TSMapView.tsx22 symbols
example/HelloWorld/App.tsx17 symbols
src/Logger.js15 symbols
example/Advanced/src/FABMenu.tsx13 symbols
scripts/xcode-helpers.js11 symbols
src/declarations/interfaces/Logger.d.ts10 symbols
example/Advanced/src/ConfigView.tsx8 symbols
Dependencies from manifests, versioned
@babel/core7.25.2 · 1×
@babel/preset-env7.25.3 · 1×
@babel/runtime7.26.0 · 1×
@expo/config-plugins4.1.0 · 1×
@gorhom/bottom-sheet5.2.8 · 1×
@ontech7/react-native-dialog1.2.0 · 1×
@react-native-community/cli20.0.0 · 1×
@react-native-community/cli-platform-android20.0.0 · 1×
@react-native-community/cli-platform-ios20.0.0 · 1×
@react-native/babel-preset0.81.5 · 1×
@react-native/eslint-config0.81.5 · 1×
For agents
$ claude mcp add react-native-background-geolocation \
-- python -m otcore.mcp_server <graph>