How kevtoe/worldview works
Worldview is a live situational-awareness dashboard: users open a 3D globe, enable data layers, inspect tracked entities and CCTV, and adjust tactical display modes. The frontend polls or propagates public-source data, renders it as globe overlays, and presents status and event feeds; an Express proxy caches and serves several feeds. The README documents additional integrations and capabilities beyond the sampled excerpts, so those are shown as documented relationships rather than claims of source inspection.
Main entry points: App.tsx App Orchestrator · index.js API Proxy · GlobeViewer.tsx 3D Globe · useFlights.ts Flight Feed
Components 29
Dashboard
- App Orchestrator
src/App.tsx - 3D Globe
src/components/globe/GlobeViewer.tsx - Entity Selection
src/components/globe/EntityClickHandler.tsx - Postprocessing Shaders
src/shaders/postprocess.ts
Globe Layers
- Flight Overlay
src/components/layers/FlightLayer.tsx - Satellite Overlay
src/components/layers/SatelliteLayer.tsx - Earthquake Overlay
src/components/layers/EarthquakeLayer.tsx - Traffic Overlay
src/components/layers/TrafficLayer.tsx - Ship Overlay
src/components/layers/ShipLayer.tsx - CCTV Overlay
src/components/layers/CCTVLayer.tsx
Data Acquisition
- Flight Feed
src/hooks/useFlights.ts - Satellite Propagation
src/hooks/useSatellites.ts - Earthquake Feed
src/hooks/useEarthquakes.ts - Traffic Simulation
src/hooks/useTraffic.ts - AIS Vessel Feed
src/hooks/useShips.ts - Camera Feed
src/hooks/useCameras.ts - Sydney Road Data
server/data/sydneyRoads.js - Page Visibility
src/hooks/usePageVisible.ts - Camera Data Types
src/types/camera.ts
Operator Interface
- Operations Controls
src/components/ui/OperationsPanel.tsx - Intel Feed
src/components/ui/IntelFeed.tsx - CCTV Panel
src/components/ui/CCTVPanel.tsx - Status Bar
src/components/ui/StatusBar.tsx - Tactical Audio
src/lib/audio.ts
Other components
- Operator
- Public Data Sources
- AISStream.io
Connections 37
- Operator → App Orchestrator: opens dashboard
- App Orchestrator → 3D Globe: mounts
src/App.tsx - App Orchestrator → Flight Overlay: renders
src/App.tsx - App Orchestrator → Satellite Overlay: renders
src/App.tsx - App Orchestrator → Earthquake Overlay: renders
src/App.tsx - App Orchestrator → Traffic Overlay: renders
src/App.tsx - App Orchestrator → Ship Overlay: renders
src/App.tsx - App Orchestrator → CCTV Overlay: renders
src/App.tsx - 3D Globe → Entity Selection: handles picks
src/components/globe/GlobeViewer.tsx - 3D Globe → Postprocessing Shaders: applies effects
src/components/globe/GlobeViewer.tsx - Flight Overlay → Flight Feed: renders data
src/components/layers/FlightLayer.tsx - Satellite Overlay → Satellite Propagation: renders data
src/components/layers/SatelliteLayer.tsx - Earthquake Overlay → Earthquake Feed: renders data
src/components/layers/EarthquakeLayer.tsx - Traffic Overlay → Traffic Simulation: renders data
src/components/layers/TrafficLayer.tsx - Ship Overlay → AIS Vessel Feed: renders data
src/components/layers/ShipLayer.tsx - CCTV Overlay → Camera Feed: renders data
src/components/layers/CCTVLayer.tsx - Flight Feed → Page Visibility: checks visibility
src/hooks/useFlights.ts - AIS Vessel Feed → Page Visibility: checks visibility
src/hooks/useShips.ts - Flight Feed → API Proxy: fetches feed
- Traffic Simulation → API Proxy: requests roads
src/hooks/useTraffic.ts - AIS Vessel Feed → API Proxy: fetches vessels
src/hooks/useShips.ts - Camera Feed → API Proxy: fetches cameras
- Satellite Propagation → Public Data Sources: loads TLEs
- Earthquake Feed → Public Data Sources: loads events
- API Proxy → AISStream.io: collects vessel data
server/index.js - API Proxy → Public Data Sources: proxies feeds
- API Entry → API Proxy: delegates to
api/index.js - API Proxy → Sydney Road Data: uses road data
server/index.js - App Orchestrator → Operations Controls: renders controls
src/App.tsx - App Orchestrator → Intel Feed: renders feed
src/App.tsx - App Orchestrator → CCTV Panel: renders panel
src/App.tsx - App Orchestrator → Status Bar: renders status
src/App.tsx - Operations Controls → Postprocessing Shaders: selects mode
src/components/ui/OperationsPanel.tsx - Operator → Entity Selection: selects entity
- Camera Feed → Camera Data Types: normalizes as
src/hooks/useCameras.ts - CCTV Panel → Camera Data Types: displays feeds
src/components/ui/CCTVPanel.tsx - App Orchestrator → Tactical Audio: plays interface cues