How strandedkitty/streets-gl works
Streets GL is a browser-based real-time 3D OpenStreetMap viewer. Users navigate or search a map location; the application loads vector tiles and terrain, converts map features into renderable geometry, and displays the scene with configurable time and visual effects. The graph follows the documented data sources and capabilities and the sampled application, worker, and feature-handler code. Several subsystem connections are documented or suggested by the tree rather than verified in sampled implementations, so uncertain call-level links are omitted.
Main entry points: TileObjectsSystem.ts Map scene objects · WorkerInstance.ts Tile worker · UI.tsx Map interface · RenderSystem.ts Render orchestration
Components 23
Viewer experience
- App lifecycle
src/app/App.ts - Map interface
src/app/ui/UI.tsx - Navigation
src/app/systems/ControlsSystem.ts - Global search
src/app/ui/components/SearchPanel/SearchPanel.tsx - Settings
src/app/systems/SettingsSystem.ts - Map time
src/app/systems/MapTimeSystem.ts
Map data
- Tile loading
src/app/systems/TileLoadingSystem.ts - Tile server
- Worker coordination
src/app/systems/MapWorkerSystem.ts - Tile worker
src/app/world/worker/WorkerInstance.ts - Vector tile provider
src/lib/tile-processing/tile3d/providers/Tile3DFromVectorProvider.ts - OSM feature processing
src/lib/tile-processing/vector/handlers/OSMRelationHandler.ts
Scene construction
- Terrain heights
src/app/systems/TerrainSystem.ts - 3D geometry
src/lib/tile-processing/tile3d/handlers/VectorAreaHandler.ts - Map scene objects
src/app/systems/TileObjectsSystem.ts - Air traffic
src/app/systems/VehicleSystem.ts
Rendering
- Render orchestration
src/app/systems/RenderSystem.ts - Render passes
src/app/render/passes/Pass.ts - Visual effects
src/app/render/passes/TAAPass.ts
Graphics engine
- Render graph
src/lib/render-graph/RenderGraph.ts - WebGL2 renderer
src/lib/renderer/webgl2-renderer/WebGL2Renderer.ts
Other components
- Map viewer
- Nominatim
Connections 23
- Map viewer → Map interface: interacts
- Map interface → Navigation: changes view
- Map interface → Global search: searches
- Global search → Nominatim: queries
- App lifecycle → Map interface: initializes
- App lifecycle → Render orchestration: updates systems
- Tile loading → Tile server: requests tiles
- Tile loading → Worker coordination: dispatches tiles
- Worker coordination → Tile worker: assigns work
- Tile worker → Vector tile provider: loads features
- Vector tile provider → OSM feature processing: processes OSM
- Tile worker → Terrain heights: requests heights
- Tile worker → 3D geometry: converts features
- Terrain heights → Map scene objects: supplies terrain
- 3D geometry → Map scene objects: creates features
- Air traffic → Map scene objects: adds aircraft
- Map time → Map scene objects: sets time
- Settings → Render orchestration: configures rendering
- Map scene objects → Render orchestration: supplies scene
- Render orchestration → Render passes: runs passes
- Render passes → Render graph: registers work
- Render graph → WebGL2 renderer: executes passes
- Render passes → Visual effects: includes effects