# afolabi-adesina-m/flappy-kiro-aws-workshop architecture

> Architecture diagram of the GitHub repository afolabi-adesina-m/flappy-kiro-aws-workshop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/afolabi-adesina-m/flappy-kiro-aws-workshop
- Repository: https://github.com/afolabi-adesina-m/flappy-kiro-aws-workshop

## Overview

Flappy Kiro is a browser-based endless-scroller game. The player opens the HTML shell, starts or resumes a run, flaps to avoid pipes, and tries to beat the saved best score. The documented runtime centers on game.js, with configuration, screens, styling, audio, and browser storage supporting play. The tree contains no source excerpts, so links between runtime files are limited to relationships stated in the README; no unlisted modules are included.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Game interface"]
  node_shell["HTML shell"]
  node_styles["Retro styling"]
end

subgraph group_runtime["Game runtime"]
  node_engine["Game loop"]
  node_config["Game constants"]
  node_physics["Player physics"]
  node_obstacles["Pipe difficulty"]
  node_states["Game states"]
  node_rendering["Canvas rendering"]
  node_effects["Visual effects"]
  node_scoring["Score tracking"]
end

subgraph group_assets["Game assets"]
  node_audio["Sound effects"]
  node_jump["Flap sound"]
  node_death["Death sound"]
end

subgraph group_browser["Browser services"]
  node_canvas["Canvas API"]
  node_storage[("Local storage")]
end

node_player(("Player"))

node_player -->|"opens"| node_shell
node_shell -.->|"hosts"| node_engine
node_engine -->|"uses constants"| node_config
node_engine -->|"simulates"| node_physics
node_engine -->|"advances"| node_obstacles
node_engine -->|"manages"| node_states
node_engine -->|"renders"| node_rendering
node_rendering -->|"draws with"| node_canvas
node_engine -->|"produces"| node_effects
node_engine -->|"tracks"| node_scoring
node_scoring -->|"saves best score"| node_storage
node_engine -->|"plays"| node_audio
node_audio -.->|"uses"| node_jump
node_audio -.->|"uses"| node_death
node_shell -.->|"styled by"| node_styles

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_shell,node_styles toneBlue
class node_engine,node_config,node_physics,node_obstacles,node_states,node_rendering,node_effects,node_scoring toneAmber
class node_audio,node_jump,node_death toneMint
class node_canvas,node_storage toneRose
class node_player toneIndigo
```

## Components

### Game interface

- **HTML shell**
- **Retro styling**

### Game runtime

- **Game loop**
- **Game constants**
- **Player physics**
- **Pipe difficulty**
- **Game states**
- **Canvas rendering**
- **Visual effects**
- **Score tracking**

### Game assets

- **Sound effects**
- **Flap sound**
- **Death sound**

### Browser services

- **Canvas API**
- **Local storage**

### Other components

- **Player**

## Connections

- Player → HTML shell: opens (evidence: `README.md`)
- HTML shell → Game loop: hosts
- Game loop → Game constants: uses constants (evidence: `README.md`)
- Game loop → Player physics: simulates (evidence: `README.md`)
- Game loop → Pipe difficulty: advances (evidence: `README.md`)
- Game loop → Game states: manages (evidence: `README.md`)
- Game loop → Canvas rendering: renders (evidence: `README.md`)
- Canvas rendering → Canvas API: draws with (evidence: `README.md`)
- Game loop → Visual effects: produces (evidence: `README.md`)
- Game loop → Score tracking: tracks (evidence: `README.md`)
- Score tracking → Local storage: saves best score (evidence: `README.md`)
- Game loop → Sound effects: plays (evidence: `README.md`)
- Sound effects → Flap sound: uses
- Sound effects → Death sound: uses
- HTML shell → Retro styling: styled by
