npm.io
1.1.2 • Published 3 months ago

@react-native-nitro-geolocation/rozenite-plugin

Licence
MIT
Version
1.1.2
Deps
1
Size
422 kB
Vulns
0
Weekly
0
Stars
116

@react-native-nitro-geolocation/rozenite-plugin

Rozenite DevTools Plugin for react-native-nitro-geolocation. Mock geolocation data in development with an interactive map interface.

Prerequisites: This plugin requires Rozenite DevTools to be set up in your project. Follow the Rozenite installation guide to configure DevTools before using this plugin.

API Compatibility: This DevTools plugin only works with the Modern API (react-native-nitro-geolocation). It does not support the Compat API (react-native-nitro-geolocation/compat).

Demo

DevTools Plugin Demo

Features

  • Interactive map-based position control
  • Click on map to set location
  • Arrow key navigation for precise adjustments
  • 20 pre-configured city locations
  • Manual latitude/longitude input
  • Real-time heading, speed, and accuracy calculation
  • Dark mode support

Installation

npm install @react-native-nitro-geolocation/rozenite-plugin
# or
yarn add @react-native-nitro-geolocation/rozenite-plugin

Usage

Add the devtools hook to your app:

import { useGeolocationDevTools } from "@react-native-nitro-geolocation/rozenite-plugin";

function App() {
  useGeolocationDevTools();

  return <YourApp />;
}
With initial position
Using city presets
import {
  useGeolocationDevTools,
  createPosition,
} from "@react-native-nitro-geolocation/rozenite-plugin";

function App() {
  useGeolocationDevTools({
    initialPosition: createPosition("Dubai, UAE"),
  });

  return <YourApp />;
}
Using custom coordinates
import {
  useGeolocationDevTools,
  type Position,
} from "@react-native-nitro-geolocation/rozenite-plugin";

const customPosition: Position = {
  coords: {
    latitude: 37.7749,
    longitude: -122.4194,
    altitude: 0,
    accuracy: 100,
    altitudeAccuracy: 100,
    heading: 0,
    speed: 0,
  },
  timestamp: Date.now(),
};

function App() {
  useGeolocationDevTools({
    initialPosition: customPosition,
  });

  return <YourApp />;
}
Available city presets

Seoul, Tokyo, New York, Los Angeles, San Francisco, London, Paris, Berlin, Sydney, Singapore, Hong Kong, Shanghai, Beijing, Dubai, Mumbai, Bangkok, Toronto, São Paulo, Mexico City, Moscow

Opening DevTools

  1. Start your React Native app with Metro
  2. Press j in the Metro terminal
  3. Enable the Geolocation plugin in DevTools
  4. Start mocking locations!

Controls

  • Click map: Set location instantly
  • Arrow keys: Move position precisely
  • Input fields: Enter exact coordinates
  • Dropdown: Select city preset

License

MIT License.

Keywords