# rawprogress/fable-cities architecture

> Architecture diagram of the GitHub repository rawprogress/fable-cities, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rawprogress/fable-cities
- Repository: https://github.com/rawprogress/fable-cities

## Overview

Fable Cities is a browser-based city-building game. The player chooses a seed or demo city, then builds roads, zones adjacent lots, and lets the simulation grow the city; the game renders the resulting terrain, buildings, traffic, weather, and audio. The graph shows the documented gameplay stages and the module-loading structure visible in the excerpts. Several subsystem internals were not sampled, so their connections are limited to registry wiring or README-documented capabilities.

Main entry points: [`src/modules/registry.js`](https://github.com/rawprogress/fable-cities/blob/main/src/modules/registry.js) (Module registry), [`src/main.js`](https://github.com/rawprogress/fable-cities/blob/main/src/main.js) (Game bootstrap), [`src/modules/roads/RoadNetwork.js`](https://github.com/rawprogress/fable-cities/blob/main/src/modules/roads/RoadNetwork.js) (Road network), [`src/modules/zoning/index.js`](https://github.com/rawprogress/fable-cities/blob/main/src/modules/zoning/index.js) (Zoning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup &amp; world"]
  node_startmenu["Start menu<br/>[index.js]"]
  node_bootstrap["Game bootstrap<br/>[main.js]"]
  node_registry["Module registry<br/>[registry.js]"]
  node_world["World state<br/>[World.js]"]
  node_engine["Render engine<br/>[Engine.js]"]
end

subgraph group_city["City construction"]
  node_roads["Road network<br/>[RoadNetwork.js]"]
  node_zoning["Zoning<br/>[index.js]"]
  node_buildings["Buildings<br/>[index.js]"]
  node_props["Street props<br/>[index.js]"]
end

subgraph group_simulation["Simulation"]
  node_simulation["City simulation<br/>[index.js]"]
  node_traffic["Traffic<br/>[index.js]"]
end

subgraph group_rendering["World presentation"]
  node_terrain["Terrain &amp; water<br/>[index.js]"]
  node_environment["Sky &amp; weather<br/>[index.js]"]
  node_effects["Visual effects<br/>[index.js]"]
  node_audio["Procedural audio<br/>[index.js]"]
end

subgraph group_interaction["Player interface"]
  node_tools["Build tools<br/>[index.js]"]
  node_ui["HUD &amp; interface<br/>[index.js]"]
end

node_player(("Player"))

node_player -->|"chooses city"| node_startmenu
node_startmenu -->|"sets start choice"| node_bootstrap
node_bootstrap -->|"loads modules"| node_registry
node_bootstrap -->|"creates world"| node_world
node_bootstrap -->|"creates engine"| node_engine
node_registry -->|"registers"| node_terrain
node_registry -->|"registers"| node_environment
node_registry -->|"registers"| node_roads
node_registry -->|"registers"| node_zoning
node_registry -->|"registers"| node_buildings
node_registry -->|"registers"| node_props
node_registry -->|"registers"| node_simulation
node_registry -->|"registers"| node_traffic
node_registry -->|"registers"| node_tools
node_registry -->|"registers"| node_ui
node_registry -->|"registers"| node_effects
node_registry -->|"registers"| node_audio
node_player -->|"draws roads"| node_tools
node_player -->|"zones frontage"| node_zoning
node_player -->|"uses HUD"| node_ui
node_roads -->|"frontage cells"| node_zoning
node_simulation -.->|"grows city"| node_buildings
node_roads -->|"lane graph"| node_traffic
node_engine -->|"hosts postprocessing"| node_effects

click node_startmenu "https://github.com/rawprogress/fable-cities/blob/main/src/modules/menu/index.js"
click node_bootstrap "https://github.com/rawprogress/fable-cities/blob/main/src/main.js"
click node_registry "https://github.com/rawprogress/fable-cities/blob/main/src/modules/registry.js"
click node_world "https://github.com/rawprogress/fable-cities/blob/main/src/core/World.js"
click node_engine "https://github.com/rawprogress/fable-cities/blob/main/src/core/Engine.js"
click node_terrain "https://github.com/rawprogress/fable-cities/blob/main/src/modules/terrain/index.js"
click node_environment "https://github.com/rawprogress/fable-cities/blob/main/src/modules/environment/index.js"
click node_roads "https://github.com/rawprogress/fable-cities/blob/main/src/modules/roads/RoadNetwork.js"
click node_zoning "https://github.com/rawprogress/fable-cities/blob/main/src/modules/zoning/index.js"
click node_buildings "https://github.com/rawprogress/fable-cities/blob/main/src/modules/buildings/index.js"
click node_props "https://github.com/rawprogress/fable-cities/blob/main/src/modules/props/index.js"
click node_simulation "https://github.com/rawprogress/fable-cities/blob/main/src/modules/simulation/index.js"
click node_traffic "https://github.com/rawprogress/fable-cities/blob/main/src/modules/traffic/index.js"
click node_tools "https://github.com/rawprogress/fable-cities/blob/main/src/modules/tools/index.js"
click node_ui "https://github.com/rawprogress/fable-cities/blob/main/src/modules/ui/index.js"
click node_effects "https://github.com/rawprogress/fable-cities/blob/main/src/modules/effects/index.js"
click node_audio "https://github.com/rawprogress/fable-cities/blob/main/src/modules/audio/index.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_startmenu,node_bootstrap,node_registry,node_world,node_engine toneBlue
class node_roads,node_zoning,node_buildings,node_props toneAmber
class node_simulation,node_traffic toneMint
class node_terrain,node_environment,node_effects,node_audio toneRose
class node_tools,node_ui,node_player toneIndigo
```

## Components

### Startup & world

- [Start menu](https://github.com/rawprogress/fable-cities/blob/main/src/modules/menu/index.js): `src/modules/menu/index.js`
- [Game bootstrap](https://github.com/rawprogress/fable-cities/blob/main/src/main.js): `src/main.js`
- [Module registry](https://github.com/rawprogress/fable-cities/blob/main/src/modules/registry.js): `src/modules/registry.js`
- [World state](https://github.com/rawprogress/fable-cities/blob/main/src/core/World.js): `src/core/World.js`
- [Render engine](https://github.com/rawprogress/fable-cities/blob/main/src/core/Engine.js): `src/core/Engine.js`

### City construction

- [Road network](https://github.com/rawprogress/fable-cities/blob/main/src/modules/roads/RoadNetwork.js): `src/modules/roads/RoadNetwork.js`
- [Zoning](https://github.com/rawprogress/fable-cities/blob/main/src/modules/zoning/index.js): `src/modules/zoning/index.js`
- [Buildings](https://github.com/rawprogress/fable-cities/blob/main/src/modules/buildings/index.js): `src/modules/buildings/index.js`
- [Street props](https://github.com/rawprogress/fable-cities/blob/main/src/modules/props/index.js): `src/modules/props/index.js`

### Simulation

- [City simulation](https://github.com/rawprogress/fable-cities/blob/main/src/modules/simulation/index.js): `src/modules/simulation/index.js`
- [Traffic](https://github.com/rawprogress/fable-cities/blob/main/src/modules/traffic/index.js): `src/modules/traffic/index.js`

### World presentation

- [Terrain & water](https://github.com/rawprogress/fable-cities/blob/main/src/modules/terrain/index.js): `src/modules/terrain/index.js`
- [Sky & weather](https://github.com/rawprogress/fable-cities/blob/main/src/modules/environment/index.js): `src/modules/environment/index.js`
- [Visual effects](https://github.com/rawprogress/fable-cities/blob/main/src/modules/effects/index.js): `src/modules/effects/index.js`
- [Procedural audio](https://github.com/rawprogress/fable-cities/blob/main/src/modules/audio/index.js): `src/modules/audio/index.js`

### Player interface

- [Build tools](https://github.com/rawprogress/fable-cities/blob/main/src/modules/tools/index.js): `src/modules/tools/index.js`
- [HUD & interface](https://github.com/rawprogress/fable-cities/blob/main/src/modules/ui/index.js): `src/modules/ui/index.js`

### Other components

- **Player**

## Connections

- Player → Start menu: chooses city (evidence: `src/modules/menu/index.js`)
- Start menu → Game bootstrap: sets start choice (evidence: `src/main.js`)
- Game bootstrap → Module registry: loads modules (evidence: `src/main.js`)
- Game bootstrap → World state: creates world (evidence: `src/main.js`)
- Game bootstrap → Render engine: creates engine (evidence: `src/main.js`)
- Module registry → Terrain & water: registers (evidence: `src/modules/registry.js`)
- Module registry → Sky & weather: registers (evidence: `src/modules/registry.js`)
- Module registry → Road network: registers (evidence: `src/modules/registry.js`)
- Module registry → Zoning: registers (evidence: `src/modules/registry.js`)
- Module registry → Buildings: registers (evidence: `src/modules/registry.js`)
- Module registry → Street props: registers (evidence: `src/modules/registry.js`)
- Module registry → City simulation: registers (evidence: `src/modules/registry.js`)
- Module registry → Traffic: registers (evidence: `src/modules/registry.js`)
- Module registry → Build tools: registers (evidence: `src/modules/registry.js`)
- Module registry → HUD & interface: registers (evidence: `src/modules/registry.js`)
- Module registry → Visual effects: registers (evidence: `src/modules/registry.js`)
- Module registry → Procedural audio: registers (evidence: `src/modules/registry.js`)
- Player → Build tools: draws roads (evidence: `README.md`)
- Player → Zoning: zones frontage (evidence: `README.md`)
- Player → HUD & interface: uses HUD (evidence: `README.md`)
- Road network → Zoning: frontage cells (evidence: `README.md`)
- City simulation → Buildings: grows city
- Road network → Traffic: lane graph (evidence: `README.md`)
- Render engine → Visual effects: hosts postprocessing (evidence: `src/modules/effects/index.js`)
