Demo app for react-native-background-geolocation plugin
JavaScript Objective-C Java Shell Python Ruby
Clone or download

[Demo App]


Fully-featured, React Native demo application for React Native Background Geolocation Module

Home Settings


$ git clone
$ cd rn-background-geolocation-demo
$ npm install

Since the Demo app uses react-native-maps, install Pods:

$ cd ios
$ pod install

Now run it:

$ react-native run-android
$ react-native run-ios

⚠️ If you're opening the Demo in XCode, use the .xcworkspace, since the Demo requires Cocoapods (due to react-native-maps)

The quickest way to see the plugin in-action is to boot the iOS simulator and simulate location with Freeway Drive.

The demo is composed of three separate and independent sub-applications:

🔷 Tracking Server

The demo app is configured to post locations to Transistor Software's demo server, which hosts a web-application for visualizing and filtering your tracking on a map.

  • After booting the app the first time, you'll be asked to enter a unique "Tracking Server Username" (eg: Github username) so the plugin can post locations to

⚠️ Make your username unique and known only to you — if every one uses "test", you'll never find your device!)

Adding Geofences

The app implements a longtap event on the map. Simply tap & hold the map to initiate adding a geofence.

Tap-hold to add geofence

Enter an identifier, radius, notifyOnExit, notifyOnEntry.