react-native-bg-geolocation 0.2.0 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/LICENSE +2 -1
  2. package/README.md +37 -3
  3. package/package.json +23 -3
package/LICENSE CHANGED
@@ -1,6 +1,7 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Zohaib Naseer
3
+ Copyright (c) 2026 Zohaib Naseer and contributors
4
+
4
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
5
6
  of this software and associated documentation files (the "Software"), to deal
6
7
  in the Software without restriction, including without limitation the rights
package/README.md CHANGED
@@ -1,8 +1,27 @@
1
+ <div align="center">
2
+
1
3
  # react-native-bg-geolocation
2
4
 
3
- Background geolocation tracking for React Native in foreground, background, Android kill state, and iOS kill state (server-triggered via the Location Push Service Extension, plus eligible OS-managed relaunches), with motion detection (moving/stationary), geofencing, and pluggable delivery (socket / HTTP / headless).
5
+ **Production-ready background geolocation for React Native apps across foreground, background, Android headless mode, and iOS Location Push Service Extension kill-state delivery.**
6
+
7
+ [![React Native](https://img.shields.io/badge/React%20Native-0.85+-61DAFB?style=for-the-badge&logo=react&logoColor=111111)](https://reactnative.dev/)
8
+ [![TypeScript](https://img.shields.io/badge/TypeScript-ready-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
9
+ [![iOS](https://img.shields.io/badge/iOS-15.1+-111111?style=for-the-badge&logo=apple&logoColor=white)](https://developer.apple.com/ios/)
10
+ [![Android](https://img.shields.io/badge/Android-background%20tracking-3DDC84?style=for-the-badge&logo=android&logoColor=111111)](https://developer.android.com/)
11
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)](LICENSE)
12
+
13
+ [![npm version](https://img.shields.io/npm/v/react-native-bg-geolocation?style=for-the-badge&logo=npm&label=npm)](https://www.npmjs.com/package/react-native-bg-geolocation)
14
+ [![npm downloads](https://img.shields.io/npm/dm/react-native-bg-geolocation?style=for-the-badge&logo=npm&label=downloads)](https://www.npmjs.com/package/react-native-bg-geolocation)
15
+ [![GitHub stars](https://img.shields.io/github/stars/ZohaibNaseer786/react-native-bg-geolocation?style=for-the-badge&logo=github)](https://github.com/ZohaibNaseer786/react-native-bg-geolocation/stargazers)
16
+ [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-support-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=111111)](https://buymeacoffee.com/zohaibnaseer)
17
+
18
+ `react-native-bg-geolocation` helps React Native apps collect and deliver reliable location updates with **foreground tracking**, **background tracking**, **geofencing**, **motion detection**, **Socket.IO / REST delivery**, **Android headless JS**, **iOS Live Activity**, and **iOS force-quit location push support**.
19
+
20
+ **Foreground Tracking | Background Tracking | Kill-State Delivery | Geofencing | Motion Detection | Socket.IO + REST Fallback | iOS Location Push | Android Headless JS**
21
+
22
+ </div>
4
23
 
5
- > Educational re-implementation of the `react-native-background-geolocation` API using only public platform APIs (FusedLocationProvider + Activity Recognition on Android, CoreLocation + CoreMotion + BGTaskScheduler on iOS). No proprietary binaries.
24
+ > Built with public platform APIs: FusedLocationProvider + Activity Recognition on Android, and CoreLocation + CoreMotion + BGTaskScheduler + CLLocationPushServiceExtension on iOS.
6
25
 
7
26
  ## Features
8
27
 
@@ -352,6 +371,21 @@ yarn
352
371
  yarn example android # or: yarn example ios
353
372
  ```
354
373
 
374
+ ## Support
375
+
376
+ If this package saves you time, please consider giving the repo a star. It helps
377
+ other React Native developers discover the project.
378
+
379
+ <div align="center">
380
+
381
+ ### Would you like to support me?
382
+
383
+ [![Follow on GitHub](https://img.shields.io/badge/Follow-@ZohaibNaseer786-181717?style=social&logo=github)](https://github.com/ZohaibNaseer786)
384
+ [![GitHub stars](https://img.shields.io/github/stars/ZohaibNaseer786/react-native-bg-geolocation?style=social)](https://github.com/ZohaibNaseer786/react-native-bg-geolocation/stargazers)
385
+ [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FF813F?style=for-the-badge&logo=buy-me-a-coffee&logoColor=white)](https://buymeacoffee.com/zohaibnaseer)
386
+
387
+ </div>
388
+
355
389
  ## Contributing
356
390
 
357
391
  - [Development workflow](CONTRIBUTING.md#development-workflow)
@@ -359,7 +393,7 @@ yarn example android # or: yarn example ios
359
393
 
360
394
  ## License
361
395
 
362
- MIT
396
+ [MIT](LICENSE) © Zohaib Naseer and contributors.
363
397
 
364
398
  ---
365
399
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "react-native-bg-geolocation",
3
- "version": "0.2.0",
4
- "description": "Background geolocation tracking for React Native",
3
+ "version": "0.2.3",
4
+ "description": "Production-ready React Native background geolocation with iOS Location Push kill-state delivery, Android headless tracking, geofencing, motion detection, Socket.IO, and REST fallback.",
5
5
  "main": "./lib/module/index.js",
6
6
  "module": "./lib/module/index.js",
7
7
  "react-native": "./src/index.tsx",
@@ -46,14 +46,34 @@
46
46
  },
47
47
  "keywords": [
48
48
  "react-native",
49
+ "react-native-geolocation",
50
+ "react-native-background-geolocation",
51
+ "background-geolocation",
52
+ "background-location",
53
+ "location-tracking",
54
+ "gps-tracking",
55
+ "mobile-location",
49
56
  "ios",
50
57
  "android",
58
+ "ios-location-push",
59
+ "location-push-service-extension",
60
+ "cllocationpushserviceextension",
61
+ "apns-location-push",
62
+ "android-headless-js",
63
+ "headless-js",
51
64
  "background",
52
65
  "geolocation",
53
66
  "location",
54
67
  "tracking",
55
68
  "geofence",
56
- "gps"
69
+ "geofencing",
70
+ "gps",
71
+ "motion-detection",
72
+ "activity-recognition",
73
+ "socket.io",
74
+ "rest-fallback",
75
+ "live-activity",
76
+ "typescript"
57
77
  ],
58
78
  "repository": {
59
79
  "type": "git",