Skip to content
Branch: master
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

[Demo App]


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

Home Settings


  git clone
  cd rn-background-geolocation-demo
  yarn install
// <or with npm>
  npm install

Now run it:

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

⚠️ If you get an iOS build error, this usually fixes it:

  cd ios
  rm Podfile.lock
  pod install

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.

You can’t perform that action at this time.