An open-source real-time geospatial intelligence dashboard built with CesiumJS. Track satellites, flights, military aircraft, earthquakes, surveillance passes, GPS jamming, maritime vessels, airspace closures, and internet outages — all on a 3D globe with military-style HUD overlays.

All data layers use free, publicly available, open data sources. No paid APIs required.

• 11 Data Layers — Satellites, Flights, Military, Earthquakes, Country Labels, CCTV, Traffic, Surveillance Passes, GPS Jamming, Maritime AIS, Airspace Closures, Internet Outages
• Visual Modes — Normal, CRT scanline, Night Vision (NVG), FLIR thermal
• Playback System — Scrub through historical positions with adjustable speed
• Military HUD — Tactical overlay with camera telemetry, MGRS coords, GSD estimation
• Keyboard Shortcuts — Quick access to visual modes, landmarks, and UI controls
• 100% Open Data — Every data layer is powered by free, open, no-auth APIs or open datasets

• Node.js >= 18
• npm >= 9

git clone https://github.com/alkeincodes/gods-eye.git
cd gods-eye

npm install

Copy the example env file:

cp .env.example .env

Edit .env with your values:

VITE_CESIUM_ION_TOKEN=your_cesium_ion_token
VITE_OPENSKY_CLIENT_ID=your_opensky_client_id
VITE_OPENSKY_CLIENT_SECRET=your_opensky_client_secret

All API keys are optional. The app runs fully without any keys — it falls back to OpenStreetMap tiles and anonymous API access. Keys only improve imagery quality and rate limits.

npm run dev

Open http://localhost:5173 in your browser.

npm run build
npm run preview

Every data layer in God's Eye is powered by free, open, publicly available data. No paid subscriptions or private APIs are used.

These keys are not required but improve the experience:

Provides high-resolution terrain and satellite imagery. Without it, the app uses OpenStreetMap tiles which work perfectly fine.

1. Create a free account at cesium.com/ion
2. Go to Access Tokens and copy your default token
3. Set VITE_CESIUM_ION_TOKEN in your .env

Provides real-time commercial flight data. Without credentials, anonymous access works but is limited to ~100 requests/day.

1. Register for free at opensky-network.org
2. Navigate to Dashboard → OAuth and create client credentials
3. Set VITE_OPENSKY_CLIENT_ID and VITE_OPENSKY_CLIENT_SECRET in your .env

• Framework — React 19, Vite 7, TypeScript 5.9
• 3D Globe — CesiumJS + Resium
• Styling — Tailwind CSS v4
• State — Zustand v5
• Satellite Propagation — satellite.js (SGP4/SDP4)
• Icons — Lucide React

Contributions are welcome! Feel free to open issues and submit pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

This project is licensed under the MIT License — you are free to use, modify, and distribute it for any purpose.

Kane Dev — Twitter · YouTube · GitHub · LinkedIn · Facebook