/rn-background-geolocation-demo

Demo app for react-native-background-geolocation plugin

Primary LanguageTypeScriptMIT LicenseMIT

[Demo App]

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

Home Settings

Installation

  git clone https://github.com/transistorsoft/rn-background-geolocation-demo.git
  cd rn-background-geolocation-demo
  yarn install
// <or with npm>
  npm install
  npx pod-install

Now run it:

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

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

  rm ios/Podfile.lock
  npx 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 tracker.transistorsoft.com.

⚠️ 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.