# poornastechtalk/make-a-wish-interactive-birthday-experience architecture

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

- Interactive diagram: https://gitdiagram.com/poornastechtalk/make-a-wish-interactive-birthday-experience
- Repository: https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience

## Overview

Make A Wish is a single-file Pygame birthday experience. The player starts and advances the intro, holds and releases SPACE to gather wish energy and blow out candles, then sees a celebratory finale; R restarts, F toggles fullscreen, and ESC exits. The graph separates the game loop and interaction stages from the procedural cake, particle effects, and celebration visuals. README capabilities are retained, but because the source excerpt omits much of the file, some internal links are not asserted.

Main entry points: [`make_a_wish.py`](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py) (Game Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_game["Game Loop<br/>[make_a_wish.py]"]
end

subgraph group_experience["Birthday Experience"]
  node_intro["Intro &amp; Countdown<br/>[make_a_wish.py]"]
  node_cake["Birthday Cake<br/>[make_a_wish.py]"]
  node_wish["Wish &amp; Wind<br/>[make_a_wish.py]"]
  node_candles["Candle Flames<br/>[make_a_wish.py]"]
end

subgraph group_visuals["Procedural Visuals"]
  node_ambience["Golden Particles<br/>[make_a_wish.py]"]
  node_sparks["Sparks &amp; Gather<br/>[make_a_wish.py]"]
  node_smoke["Candle Smoke<br/>[make_a_wish.py]"]
  node_fireworks["Fireworks &amp; Confetti<br/>[make_a_wish.py]"]
  node_typography["Animated Messages<br/>[make_a_wish.py]"]
end

node_player(("Player"))

node_player -->|"presses controls"| node_game
node_game -->|"advances scenes"| node_intro
node_player -->|"holds or releases"| node_wish
node_wish -->|"blows out"| node_candles
node_game -.->|"draws cake"| node_cake
node_game -.->|"draws particles"| node_ambience
node_game -.->|"updates effects"| node_sparks
node_game -.->|"draws smoke"| node_smoke
node_game -.->|"shows finale"| node_fireworks
node_game -.->|"draws messages"| node_typography

click node_game "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_intro "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_cake "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_wish "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_candles "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_ambience "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_sparks "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_smoke "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_fireworks "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"
click node_typography "https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py"

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_game toneBlue
class node_intro,node_cake,node_wish,node_candles toneAmber
class node_ambience,node_sparks,node_smoke,node_fireworks,node_typography toneMint
class node_player toneIndigo
```

## Components

### Game Runtime

- [Game Loop](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`

### Birthday Experience

- [Intro & Countdown](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Birthday Cake](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Wish & Wind](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Candle Flames](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`

### Procedural Visuals

- [Golden Particles](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Sparks & Gather](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Candle Smoke](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Fireworks & Confetti](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`
- [Animated Messages](https://github.com/poornastechtalk/make-a-wish-interactive-birthday-experience/blob/main/make_a_wish.py): `make_a_wish.py`

### Other components

- **Player**

## Connections

- Player → Game Loop: presses controls (evidence: `README.md`)
- Game Loop → Intro & Countdown: advances scenes (evidence: `README.md`)
- Player → Wish & Wind: holds or releases (evidence: `README.md`)
- Wish & Wind → Candle Flames: blows out (evidence: `README.md`)
- Game Loop → Birthday Cake: draws cake (evidence: `make_a_wish.py`)
- Game Loop → Golden Particles: draws particles (evidence: `make_a_wish.py`)
- Game Loop → Sparks & Gather: updates effects (evidence: `make_a_wish.py`)
- Game Loop → Candle Smoke: draws smoke (evidence: `make_a_wish.py`)
- Game Loop → Fireworks & Confetti: shows finale (evidence: `make_a_wish.py`)
- Game Loop → Animated Messages: draws messages (evidence: `make_a_wish.py`)
