Zombie

A React Native module for persistent background location tracking that keeps working even after the app is killed.

Installation

npm install react-native-zombie-gps
# or
yarn add react-native-zombie-gps

Usage

import {
  addListener,
  ready,
  startMonitoring,
  stopMonitoring,
} from 'react-native-zombie-gps';

async function bootstrapZombieGps() {
  await ready({
    apiURL: 'https://example.supabase.co/rest/v1/locations',
    headers: {
      'apikey': 'public-anon-key',
      'Authorization': 'Bearer public-anon-key',
      'Content-Type': 'application/json',
    },
    params: {
      sessionId: 'demo-session',
    },
    locationFormat: 'both', // 'latLng' | 'geohash' | 'both' (default: 'both')
    geohashLength: 12,      // 1-12 (default: 12)
  });

  const subscription = addListener((location) => {
    console.log(
      `lat=${location.latitude}, lng=${location.longitude} @ ${location.timestamp}`
    );
  });

  startMonitoring();

  return () => {
    subscription.remove?.();
    stopMonitoring();
  };
}

ready persists the upload config natively so that when iOS restarts the app in the background the native module can continue POSTing payloads shaped as { lat, lng, timestamp, params } (or with geohash) even before the React Native bridge is alive.

Configuration Options

| Option | Type | Description | |---|---|---| | apiURL | string | Required. The HTTP endpoint to POST location data to. | | headers | Record<string, string> | Optional HTTP headers (e.g. Authorization). | | params | Record<string, unknown> | Optional static JSON body parameters to include in every upload. | | locationFormat | 'latLng' \| 'geohash' \| 'both' | Shape of the location data in the body. Defaults to 'both'. | | geohashLength | number | Precision of the geohash (1-12). Defaults to 12. |

See example/src/App.tsx for a UI example that renders the active coordinates and configures a Supabase endpoint.

Development

yarn lint          # eslint
yarn format        # prettier --check
yarn format:write  # prettier --write
yarn pre-push      # lint + format (ideal for git hooks)

Contributing

• Development workflow
• Sending a pull request
• Code of conduct

License

MIT