# zaderlyl/glass_garden architecture

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

- Interactive diagram: https://gitdiagram.com/zaderlyl/glass_garden
- Repository: https://github.com/zaderlyl/glass_garden

## Overview

Glass Garden is a Phaser top-down game. The current playable loop starts in the hub, lets the player move and interact with mirrors to enter worlds, and keeps a timer visible across world changes. The graph also preserves the menu, world-specific scenes, mirror state, and save-system capability indicated by the source index and shared constants. Evidence is limited to the excerpts and index references provided; the SaveSystem implementation was read but not excerpted, so its connections are not asserted.

Main entry points: [`src/scenes/WorldScene.js`](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/WorldScene.js) (World scene base), [`src/config.js`](https://github.com/zaderlyl/glass_garden/blob/main/src/config.js) (Game configuration), [`src/scenes/UIScene.js`](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/UIScene.js) (Timer display), [`src/scenes/HubScene.js`](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/HubScene.js) (Hub scene)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Game startup"]
  node_entry["Game entry<br/>[main.js]"]
  node_config["Game configuration<br/>[config.js]"]
end

subgraph group_scenes["Game scenes"]
  node_menu["Title menu<br/>[MenuScene.js]"]
  node_hub["Hub scene<br/>[HubScene.js]"]
  node_world1["World one<br/>[World1Scene.js]"]
  node_worldbase["World scene base<br/>[WorldScene.js]"]
  node_ui["Timer display<br/>[UIScene.js]"]
end

subgraph group_gameplay["Gameplay systems"]
  node_input["Input manager<br/>[InputManager.js]"]
  node_mirrors["Mirror state<br/>[MirrorSystem.js]"]
  node_timer["Game timer<br/>[TimerSystem.js]"]
  node_save["Save system<br/>[SaveSystem.js]"]
end

subgraph group_shared["Shared state and data"]
  node_constants["Game constants<br/>[constants.js]"]
  node_helpers["Game helpers<br/>[helpers.js]"]
  node_maps["World maps"]
end

node_player(("Player"))
node_phaser["Phaser runtime"]

node_entry -->|"creates game"| node_config
node_config -->|"configures"| node_phaser
node_config -->|"registers scene"| node_menu
node_config -->|"registers scene"| node_hub
node_config -->|"registers scene"| node_world1
node_config -->|"registers scene"| node_ui
node_menu -->|"uses settings"| node_constants
node_hub -->|"extends"| node_worldbase
node_world1 -->|"extends"| node_worldbase
node_hub -->|"selects map"| node_maps
node_world1 -->|"selects map"| node_maps
node_worldbase -->|"reads actions"| node_input
node_worldbase -.->|"moves and interacts"| node_player
node_worldbase -->|"tracks mirror use"| node_mirrors
node_worldbase -->|"starts timer"| node_timer
node_worldbase -->|"raises above world"| node_ui
node_ui -->|"reads elapsed time"| node_timer
node_ui -->|"formats time"| node_helpers
node_worldbase -->|"chooses tile variants"| node_helpers
node_worldbase -->|"uses game settings"| node_constants
node_ui -->|"uses display settings"| node_constants

click node_entry "https://github.com/zaderlyl/glass_garden/blob/main/src/main.js"
click node_config "https://github.com/zaderlyl/glass_garden/blob/main/src/config.js"
click node_menu "https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/MenuScene.js"
click node_hub "https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/HubScene.js"
click node_world1 "https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/World1Scene.js"
click node_worldbase "https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/WorldScene.js"
click node_ui "https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/UIScene.js"
click node_input "https://github.com/zaderlyl/glass_garden/blob/main/src/systems/InputManager.js"
click node_mirrors "https://github.com/zaderlyl/glass_garden/blob/main/src/systems/MirrorSystem.js"
click node_timer "https://github.com/zaderlyl/glass_garden/blob/main/src/systems/TimerSystem.js"
click node_save "https://github.com/zaderlyl/glass_garden/blob/main/src/systems/SaveSystem.js"
click node_constants "https://github.com/zaderlyl/glass_garden/blob/main/src/utils/constants.js"
click node_helpers "https://github.com/zaderlyl/glass_garden/blob/main/src/utils/helpers.js"
click node_maps "https://github.com/zaderlyl/glass_garden/tree/main/assets/maps"

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_entry,node_config toneBlue
class node_menu,node_hub,node_world1,node_worldbase,node_ui toneAmber
class node_input,node_mirrors,node_timer,node_save toneMint
class node_constants,node_helpers,node_maps toneRose
class node_player,node_phaser toneIndigo
```

## Components

### Game startup

- [Game entry](https://github.com/zaderlyl/glass_garden/blob/main/src/main.js): `src/main.js`
- [Game configuration](https://github.com/zaderlyl/glass_garden/blob/main/src/config.js): `src/config.js`

### Game scenes

- [Title menu](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/MenuScene.js): `src/scenes/MenuScene.js`
- [Hub scene](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/HubScene.js): `src/scenes/HubScene.js`
- [World one](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/World1Scene.js): `src/scenes/World1Scene.js`
- [World scene base](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/WorldScene.js): `src/scenes/WorldScene.js`
- [Timer display](https://github.com/zaderlyl/glass_garden/blob/main/src/scenes/UIScene.js): `src/scenes/UIScene.js`

### Gameplay systems

- [Input manager](https://github.com/zaderlyl/glass_garden/blob/main/src/systems/InputManager.js): `src/systems/InputManager.js`
- [Mirror state](https://github.com/zaderlyl/glass_garden/blob/main/src/systems/MirrorSystem.js): `src/systems/MirrorSystem.js`
- [Game timer](https://github.com/zaderlyl/glass_garden/blob/main/src/systems/TimerSystem.js): `src/systems/TimerSystem.js`
- [Save system](https://github.com/zaderlyl/glass_garden/blob/main/src/systems/SaveSystem.js): `src/systems/SaveSystem.js`

### Shared state and data

- [Game constants](https://github.com/zaderlyl/glass_garden/blob/main/src/utils/constants.js): `src/utils/constants.js`
- [Game helpers](https://github.com/zaderlyl/glass_garden/blob/main/src/utils/helpers.js): `src/utils/helpers.js`
- [World maps](https://github.com/zaderlyl/glass_garden/tree/main/assets/maps): `assets/maps`

### Other components

- **Player**
- **Phaser runtime**

## Connections

- Game entry → Game configuration: creates game (evidence: `src/main.js`)
- Game configuration → Phaser runtime: configures (evidence: `src/config.js`)
- Game configuration → Title menu: registers scene (evidence: `src/config.js`)
- Game configuration → Hub scene: registers scene (evidence: `src/config.js`)
- Game configuration → World one: registers scene (evidence: `src/config.js`)
- Game configuration → Timer display: registers scene (evidence: `src/config.js`)
- Title menu → Game constants: uses settings (evidence: `src/scenes/MenuScene.js`)
- Hub scene → World scene base: extends (evidence: `src/scenes/HubScene.js`)
- World one → World scene base: extends (evidence: `src/scenes/World1Scene.js`)
- Hub scene → World maps: selects map (evidence: `src/scenes/HubScene.js`)
- World one → World maps: selects map (evidence: `src/scenes/World1Scene.js`)
- World scene base → Input manager: reads actions (evidence: `src/scenes/WorldScene.js`)
- World scene base → Player: moves and interacts
- World scene base → Mirror state: tracks mirror use (evidence: `src/scenes/WorldScene.js`)
- World scene base → Game timer: starts timer (evidence: `src/scenes/WorldScene.js`)
- World scene base → Timer display: raises above world (evidence: `src/scenes/WorldScene.js`)
- Timer display → Game timer: reads elapsed time (evidence: `src/scenes/UIScene.js`)
- Timer display → Game helpers: formats time (evidence: `src/scenes/UIScene.js`)
- World scene base → Game helpers: chooses tile variants (evidence: `src/scenes/WorldScene.js`)
- World scene base → Game constants: uses game settings (evidence: `src/scenes/WorldScene.js`)
- Timer display → Game constants: uses display settings (evidence: `src/scenes/UIScene.js`)
