A real-time 3D map of the world's moving things: live ship traffic (AIS), aircraft, satellites, submarine cables, ports, chokepoints, and space weather — rendered as a 1.5M-point terrain cloud with day/night, ocean simulation, and cinematic camera work. Built with Three.js and plain ES modules. No build step, no framework.

▶ Live demo — no signup needed: click VIEW DEMO on the opening screen for synthetic traffic, or paste a free aisstream.io key for live global ship data.

git clone https://github.com/jamalrfordii-arch/Vanguard-Map.git
cd Vanguard-Map
npx serve .        # or: python -m http.server 3000

Open http://localhost:3000 in a Chromium browser with hardware acceleration.

Live ship data (free): the app prompts for an aisstream.io API key on first load — free signup, the key stays in your browser's localStorage.

High-res terrain tiles (optional): get a free token at cesium.com/ion → Access Tokens, then in DevTools: localStorage.setItem('vg1_cesium_token', 'YOUR_TOKEN'). Without it the map uses the point-cloud terrain at all zoom levels.

Flights & AI copilot (optional): require the local proxy — node flight-proxy.js in a second terminal. Without it those layers stay quiet; everything else works.

The map runs on a simulated clock and pluggable data sources — DevTools console:

simClock.setTime('2026-05-10T12:00:00Z')   // scrub the world to any moment
simClock.setRate(60)                        // 1 real second = 1 sim minute
vg1Scenario.load('./scenarios/hormuz-demo.json')  // inject scripted synthetic vessels
vg1Scenario.record(); vg1Scenario.save()    // capture live AIS to NDJSON
vg1Scenario.replay('./captures/x.ndjson')   // replay a capture
vg1Invariants.stats()                       // physics-violation ledger (spoof/teleport detection)

Synthetic vessels use reserved 999… MMSIs and are scripted in scenarios/*.json.

node tests/invariants.test.mjs

One manager per domain (aisManager, flightManager, satelliteManager, …), communicating only via vg1:* DOM events — no cross-imports. All position reports pass a physics invariant gate (invariants.js) before they can move an entity. See CLAUDE.md for the full module map and contribution rules.

Open a GitHub Issue — bug reports, feature ideas, and "this ran at N fps on my machine" reports are all useful.