React Native Geo Activity Kit

A production-grade, battery-efficient background tracking and activity recognition library for React Native.

This library is designed for apps that require reliable background location tracking and activity recognition. It combines Google Fused Location Provider with the Activity Recognition Transition API to create a Smart Tracking Engine that automatically adjusts GPS frequency based on user movement — ensuring high accuracy when moving and near-zero battery drain when stationary.

---

🚀 Key Features

$3

- Stationary Mode: Defaults to 5-minute intervals when the device is still.
- High-Speed Mode: Automatically switches to 30-second intervals the millisecond movement is detected.

$3

- Uses EXIT STILL transitions to trigger GPS immediately when a user stands up or picks up the phone.

$3

- Runs reliably in the background with a persistent notification.
- Fully compatible with Android 14 foreground service requirements.

$3

- Geofence Alerts
- Entry (Green) and Exit (Red) pre-styled notifications.
- Generic Alerts
- Trigger custom notifications for background push messages or updates.

$3

Detects the following activities:
- STILL
- WALKING
- RUNNING
- IN_VEHICLE
- ON_BICYCLE

$3

- Detects when the user physically toggles the System Location (GPS) switch ON/OFF.

$3

- Every location update includes an is_mock flag to detect spoofed locations.

---

📦 Installation

``bash
npm install react-native-geo-activity-kit


or


yarn add react-native-geo-activity-kit
`

---

⚙️ Android Configuration (Required)

Because this library runs continuously in the background, AndroidManifest.xml configuration is mandatory.

$3

Open android/app/src/main/AndroidManifest.xml and add:

`xml













`

---

$3

Inside the tag:

`xml


android:name="com.rngeoactivitykit.TrackingService"
android:enabled="true"
android:exported="false"
android:foregroundServiceType="location" />

android:name="com.rngeoactivitykit.ActivityTransitionReceiver"
android:exported="false"
android:permission="com.google.android.gms.permission.ACTIVITY_RECOGNITION">






`

---

📖 Usage Guide

$3

`javascript
import { PermissionsAndroid, Platform } from 'react-native';

async function requestPermissions() {
if (Platform.OS === 'android') {
await PermissionsAndroid.requestMultiple([
PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
PermissionsAndroid.PERMISSIONS.ACCESS_BACKGROUND_LOCATION,
PermissionsAndroid.PERMISSIONS.ACTIVITY_RECOGNITION,
PermissionsAndroid.PERMISSIONS.POST_NOTIFICATIONS,
]);
}
}
`

---

$3

`javascript
import GeoKit from 'react-native-geo-activity-kit';

const startTracking = async () => {
await GeoKit.startForegroundService(
'Location Service Active',
'Tracking location in background',
9991
);

await GeoKit.startMotionDetector();
};
`

---

$3

`javascript
import { useEffect } from 'react';
import GeoKit from 'react-native-geo-activity-kit';

useEffect(() => {
const locationSub = GeoKit.addLocationLogListener((event) => {
console.log(event.latitude, event.longitude);

if (event.is_mock) {
console.warn('FAKE GPS DETECTED');
}
});

const motionSub = GeoKit.addMotionListener((event) => {
console.log(event.activity, event.isMoving);
});

const gpsSub = GeoKit.addGpsStatusListener((event) => {
if (!event.enabled) {
console.error('GPS turned OFF');
}
});

return () => {
locationSub.remove();
motionSub.remove();
gpsSub.remove();
};
}, []);
`

---

🔔 Notification API

$3

`javascript
GeoKit.fireGeofenceAlert('OUT', 'User');
GeoKit.fireGeofenceAlert('IN', 'User');
`

---

$3

`javascript
GeoKit.fireGenericAlert('New Task', 'You have a new site visit.', 1001);
`

---

$3

`javascript
GeoKit.cancelGenericAlert(1001);
``

---

📚 API Reference

$3

| Method | Description |
|------|------------|
| startForegroundService | Starts persistent background service |
| stopForegroundService | Stops service |
| updateServiceNotification | Updates notification text |

---

$3

| Method | Description |
|------|------------|
| startMotionDetector | Enables activity recognition |
| stopMotionDetector | Stops motion detection |
| setLocationUpdateInterval | Manual GPS override |
| registerGpsListener | Monitor GPS toggle |

---

📱 Supported Platforms

- Android: SDK 29 (Android 10) to SDK 34 (Android 14)
- iOS: Not supported

---

🧩 Troubleshooting

$3

Ensure notification ID is an integer.

$3

This is expected behavior in stationary mode.

$3

Ensure a mock location app is actively spoofing.

---

📄 License

MIT

---

👤 Author

Kartikey Mishra
Creator & Maintainer of React Native Geo Activity Kit