# abdulazizalrashidi/glimmer architecture

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

- Interactive diagram: https://gitdiagram.com/abdulazizalrashidi/glimmer
- Repository: https://github.com/abdulazizalrashidi/glimmer

## Overview

Glimmer is a Rust neon maze-chase game. The player’s input is polled by the app, which advances a fixed-step game session; the session presents the resulting state through the renderer and audio, while scores and settings persist locally. The game logic is deliberately headless and reports events that presentation systems can react to. The graph also includes the documented demo, interludes, how-to, options, and score screens. Relationships use README statements and source-index references; unsampled screen and runtime details are not inferred beyond those references.

Main entry points: [`src/app.rs`](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app.rs) (App dispatcher), [`src/app/session.rs`](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/session.rs) (Game session), [`src/game.rs`](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/game.rs) (Game rules), [`src/render/mod.rs`](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/mod.rs) (World renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and screens"]
  node_input["Input mapping<br/>[input.rs]"]
  node_app_shell["App dispatcher<br/>[app.rs]"]
  node_session["Game session<br/>[session.rs]"]
  node_menus["Title and menus<br/>[menu.rs]"]
  node_title["Title screen<br/>[title.rs]"]
  node_howto["How-to screen<br/>[howto.rs]"]
  node_interludes["Animated interludes<br/>[interlude.rs]"]
  node_options["Options screen<br/>[options.rs]"]
  node_scores["High-score screen<br/>[scores.rs]"]
end

subgraph group_simulation["Game simulation"]
  node_game["Game rules<br/>[game.rs]"]
  node_player_rules["Player movement<br/>[player.rs]"]
  node_shades["Shade AI<br/>[shade.rs]"]
  node_actor["Actor movement<br/>[actor.rs]"]
  node_maze["Maze rules<br/>[maze.rs]"]
  node_maze_data["Built-in mazes<br/>[mazes.rs]"]
  node_autopilot["Demo autopilot<br/>[autopilot.rs]"]
end

subgraph group_presentation["Rendering and audio"]
  node_renderer["World renderer<br/>[mod.rs]"]
  node_sprites["Procedural sprites<br/>[sprites.rs]"]
  node_particles["Particle effects<br/>[particles.rs]"]
  node_font["Generated font<br/>[font.rs]"]
  node_sound["Game audio bridge<br/>[sound.rs]"]
  node_audio["Audio playback<br/>[audio.rs]"]
  node_synth["Procedural sound<br/>[synth.rs]"]
end

subgraph group_storage["Local persistence"]
  node_save[("Settings and scores<br/>[save.rs]")]
end

node_player(("Player"))

node_player -->|"provides controls"| node_input
node_input -->|"supplies actions"| node_app_shell
node_app_shell -->|"dispatches session"| node_session
node_app_shell -->|"routes screens"| node_title
node_app_shell -->|"uses menu UI"| node_menus
node_app_shell -->|"routes screens"| node_howto
node_app_shell -->|"routes screens"| node_interludes
node_app_shell -->|"routes screens"| node_options
node_app_shell -->|"routes screens"| node_scores
node_session -->|"advances simulation"| node_game
node_session -->|"renders state"| node_renderer
node_session -->|"uses demo play"| node_autopilot
node_game -->|"updates player"| node_player_rules
node_game -->|"updates shades"| node_shades
node_game -->|"uses maze rules"| node_maze
node_game -->|"uses movement"| node_actor
node_maze -->|"loads built-ins"| node_maze_data
node_autopilot -->|"plays simulation"| node_game
node_renderer -->|"draws sprites"| node_sprites
node_renderer -->|"updates effects"| node_particles
node_renderer -->|"draws text"| node_font
node_session -->|"handles game events"| node_sound
node_sound -->|"plays effects"| node_audio
node_sound -->|"uses generated audio"| node_synth
node_app_shell -->|"loads and saves"| node_save
node_options -->|"persists settings"| node_save
node_scores -->|"reads and writes scores"| node_save
node_session -->|"saves game score"| node_save

click node_input "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/input.rs"
click node_app_shell "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app.rs"
click node_session "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/session.rs"
click node_menus "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/menu.rs"
click node_title "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/title.rs"
click node_howto "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/howto.rs"
click node_interludes "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/interlude.rs"
click node_options "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/options.rs"
click node_scores "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/scores.rs"
click node_game "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/game.rs"
click node_player_rules "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/player.rs"
click node_shades "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/shade.rs"
click node_actor "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/actor.rs"
click node_maze "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/maze.rs"
click node_maze_data "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/mazes.rs"
click node_autopilot "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/autopilot.rs"
click node_renderer "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/mod.rs"
click node_sprites "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/sprites.rs"
click node_particles "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/particles.rs"
click node_font "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/font.rs"
click node_sound "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/sound.rs"
click node_audio "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/audio.rs"
click node_synth "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/synth.rs"
click node_save "https://github.com/abdulazizalrashidi/glimmer/blob/main/src/save.rs"

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_input,node_app_shell,node_session,node_menus,node_title,node_howto,node_interludes,node_options,node_scores toneBlue
class node_game,node_player_rules,node_shades,node_actor,node_maze,node_maze_data,node_autopilot toneAmber
class node_renderer,node_sprites,node_particles,node_font,node_sound,node_audio,node_synth toneMint
class node_save toneRose
class node_player toneIndigo
```

## Components

### App and screens

- [Input mapping](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/input.rs): `src/input.rs`
- [App dispatcher](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app.rs): `src/app.rs`
- [Game session](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/session.rs): `src/app/session.rs`
- [Title and menus](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/menu.rs): `src/app/menu.rs`
- [Title screen](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/title.rs): `src/app/title.rs`
- [How-to screen](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/howto.rs): `src/app/howto.rs`
- [Animated interludes](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/interlude.rs): `src/app/interlude.rs`
- [Options screen](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/options.rs): `src/app/options.rs`
- [High-score screen](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/scores.rs): `src/app/scores.rs`

### Game simulation

- [Game rules](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/game.rs): `src/game.rs`
- [Player movement](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/player.rs): `src/player.rs`
- [Shade AI](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/shade.rs): `src/shade.rs`
- [Actor movement](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/actor.rs): `src/actor.rs`
- [Maze rules](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/maze.rs): `src/maze.rs`
- [Built-in mazes](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/mazes.rs): `src/mazes.rs`
- [Demo autopilot](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/autopilot.rs): `src/autopilot.rs`

### Rendering and audio

- [World renderer](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/mod.rs): `src/render/mod.rs`
- [Procedural sprites](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/sprites.rs): `src/render/sprites.rs`
- [Particle effects](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/render/particles.rs): `src/render/particles.rs`
- [Generated font](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/font.rs): `src/font.rs`
- [Game audio bridge](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/app/sound.rs): `src/app/sound.rs`
- [Audio playback](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/audio.rs): `src/audio.rs`
- [Procedural sound](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/synth.rs): `src/synth.rs`

### Local persistence

- [Settings and scores](https://github.com/abdulazizalrashidi/glimmer/blob/main/src/save.rs): `src/save.rs`

### Other components

- **Player**

## Connections

- Player → Input mapping: provides controls (evidence: `README.md`)
- Input mapping → App dispatcher: supplies actions (evidence: `src/app.rs`)
- App dispatcher → Game session: dispatches session (evidence: `src/app.rs`)
- App dispatcher → Title screen: routes screens (evidence: `src/app.rs`)
- App dispatcher → Title and menus: uses menu UI (evidence: `src/app.rs`)
- App dispatcher → How-to screen: routes screens (evidence: `src/app.rs`)
- App dispatcher → Animated interludes: routes screens (evidence: `src/app.rs`)
- App dispatcher → Options screen: routes screens (evidence: `src/app.rs`)
- App dispatcher → High-score screen: routes screens (evidence: `src/app.rs`)
- Game session → Game rules: advances simulation (evidence: `src/app/session.rs`)
- Game session → World renderer: renders state (evidence: `src/app/session.rs`)
- Game session → Demo autopilot: uses demo play (evidence: `src/app/session.rs`)
- Game rules → Player movement: updates player (evidence: `src/game.rs`)
- Game rules → Shade AI: updates shades (evidence: `src/game.rs`)
- Game rules → Maze rules: uses maze rules (evidence: `src/game.rs`)
- Game rules → Actor movement: uses movement (evidence: `src/game.rs`)
- Maze rules → Built-in mazes: loads built-ins (evidence: `src/maze.rs`)
- Demo autopilot → Game rules: plays simulation (evidence: `src/autopilot.rs`)
- World renderer → Procedural sprites: draws sprites (evidence: `src/render/mod.rs`)
- World renderer → Particle effects: updates effects (evidence: `src/render/mod.rs`)
- World renderer → Generated font: draws text (evidence: `src/render/mod.rs`)
- Game session → Game audio bridge: handles game events (evidence: `src/app/session.rs`)
- Game audio bridge → Audio playback: plays effects (evidence: `src/app/sound.rs`)
- Game audio bridge → Procedural sound: uses generated audio (evidence: `src/app/sound.rs`)
- App dispatcher → Settings and scores: loads and saves (evidence: `src/app.rs`)
- Options screen → Settings and scores: persists settings (evidence: `src/app/options.rs`)
- High-score screen → Settings and scores: reads and writes scores (evidence: `src/app/scores.rs`)
- Game session → Settings and scores: saves game score (evidence: `src/app/session.rs`)
