# zaintahir2025/flappy-bird architecture

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

- Interactive diagram: https://gitdiagram.com/zaintahir2025/flappy-bird
- Repository: https://github.com/zaintahir2025/flappy-bird

## Overview

Skybound Edition is a cross-platform Flutter arcade game. Players start a flight, control the bird through biome-themed obstacles and power-ups, then build career progress through local scores, gems, quests, and unlockable content. The graph preserves the README’s documented game, progression, audio, and storage capabilities. Dart implementation excerpts were not provided, so relationships are limited to README statements; platform runner nodes represent hosting/bootstrap code, not game logic.

Main entry points: [`lib/home_page.dart`](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/home_page.dart) (Game loop and HUD), [`lib/score_storage.dart`](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage.dart) (Storage facade), [`lib/leaderboard_dialog.dart`](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/leaderboard_dialog.dart) (Leaderboard dialog), [`lib/main.dart`](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Flight gameplay"]
  node_game["Game loop and HUD<br/>[home_page.dart]"]
  node_models["Game models<br/>[game_models.dart]"]
  node_bird["Bird and flight<br/>[bird.dart]"]
  node_barriers["Biome obstacles<br/>[barriers.dart]"]
  node_effects["Particle effects"]
end

subgraph group_progression["Progression and records"]
  node_quests["Quest challenges<br/>[quests_dialog.dart]"]
  node_leaderboard["Leaderboard dialog"]
  node_stats["Career data"]
end

subgraph group_experience["Menus and presentation"]
  node_app["App entry<br/>[main.dart]"]
  node_worlds["World selection"]
  node_skins["Skin shop"]
  node_name["Pilot callsign"]
  node_settings["Settings"]
  node_audio["Audio manager<br/>[audio_manager.dart]"]
  node_audio_assets["Audio assets"]
end

subgraph group_persistence["Local persistence"]
  node_storage["Storage facade<br/>[score_storage.dart]"]
  node_native_storage["Native storage"]
  node_web_storage["Web storage"]
  node_storage_contract["Storage contract"]
end

subgraph group_platform["Platform hosting"]
  node_windows_runner["Windows runner<br/>[win32_window.cpp]"]
  node_windows_flutter["Flutter window host<br/>[flutter_window.cpp]"]
  node_windows_entry["Windows entry<br/>[main.cpp]"]
  node_linux_app["Linux application host<br/>[my_application.cc]"]
  node_linux_plugins["Linux plugin registration"]
  node_ios_app["iOS app delegate<br/>[AppDelegate.swift]"]
  node_macos_plugins["macOS plugin registration"]
end

node_player(("Player"))

node_player -->|"opens"| node_app
node_app -->|"starts game"| node_game
node_player -->|"controls flight"| node_game
node_game -->|"renders flyer"| node_bird
node_game -->|"renders obstacles"| node_barriers
node_game -->|"uses game data"| node_models
node_game -.->|"shows effects"| node_effects
node_game -->|"opens selector"| node_worlds
node_game -->|"opens shop"| node_skins
node_game -->|"opens quests"| node_quests
node_game -->|"opens rankings"| node_leaderboard
node_game -->|"opens settings"| node_settings
node_game -->|"requests callsign"| node_name
node_leaderboard -->|"shows career stats"| node_stats
node_game -->|"tracks career"| node_stats
node_settings -->|"configures sound"| node_audio
node_audio -->|"plays audio"| node_audio_assets
node_game -->|"persists scores"| node_storage
node_storage -->|"selects native"| node_native_storage
node_storage -->|"selects web"| node_web_storage
node_storage -->|"uses contract"| node_storage_contract
node_windows_entry -->|"creates window"| node_windows_flutter
node_windows_flutter -->|"inherits window"| node_windows_runner
node_linux_app -->|"registers plugins"| node_linux_plugins
node_ios_app -.->|"registers plugins"| node_macos_plugins

click node_app "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/main.dart"
click node_game "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/home_page.dart"
click node_models "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/game_models.dart"
click node_bird "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/bird.dart"
click node_barriers "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/barriers.dart"
click node_effects "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/particle_effects.dart"
click node_worlds "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/world_select_dialog.dart"
click node_skins "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/skin_shop_dialog.dart"
click node_quests "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/quests_dialog.dart"
click node_leaderboard "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/leaderboard_dialog.dart"
click node_stats "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/leaderboard_model.dart"
click node_name "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/name_input_dialog.dart"
click node_settings "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/settings_dialog.dart"
click node_audio "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/audio_manager.dart"
click node_audio_assets "https://github.com/zaintahir2025/flappy-bird/tree/main/assets/audio"
click node_storage "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage.dart"
click node_native_storage "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_io.dart"
click node_web_storage "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_web.dart"
click node_storage_contract "https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_stub.dart"
click node_windows_runner "https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/win32_window.cpp"
click node_windows_flutter "https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/flutter_window.cpp"
click node_windows_entry "https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/main.cpp"
click node_linux_app "https://github.com/zaintahir2025/flappy-bird/blob/main/linux/my_application.cc"
click node_linux_plugins "https://github.com/zaintahir2025/flappy-bird/blob/main/linux/flutter/generated_plugin_registrant.cc"
click node_ios_app "https://github.com/zaintahir2025/flappy-bird/blob/main/ios/Runner/AppDelegate.swift"
click node_macos_plugins "https://github.com/zaintahir2025/flappy-bird/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"

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,node_models,node_bird,node_barriers,node_effects toneBlue
class node_quests,node_leaderboard,node_stats toneAmber
class node_app,node_worlds,node_skins,node_name,node_settings,node_audio,node_audio_assets toneMint
class node_storage,node_native_storage,node_web_storage,node_storage_contract toneRose
class node_windows_runner,node_windows_flutter,node_windows_entry,node_linux_app,node_linux_plugins,node_ios_app,node_macos_plugins,node_player toneIndigo
```

## Components

### Flight gameplay

- [Game loop and HUD](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/home_page.dart): `lib/home_page.dart`
- [Game models](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/game_models.dart): `lib/game_models.dart`
- [Bird and flight](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/bird.dart): `lib/bird.dart`
- [Biome obstacles](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/barriers.dart): `lib/barriers.dart`
- [Particle effects](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/particle_effects.dart): `lib/particle_effects.dart`

### Progression and records

- [Quest challenges](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/quests_dialog.dart): `lib/quests_dialog.dart`
- [Leaderboard dialog](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/leaderboard_dialog.dart): `lib/leaderboard_dialog.dart`
- [Career data](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/leaderboard_model.dart): `lib/leaderboard_model.dart`

### Menus and presentation

- [App entry](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/main.dart): `lib/main.dart`
- [World selection](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/world_select_dialog.dart): `lib/world_select_dialog.dart`
- [Skin shop](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/skin_shop_dialog.dart): `lib/skin_shop_dialog.dart`
- [Pilot callsign](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/name_input_dialog.dart): `lib/name_input_dialog.dart`
- [Settings](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/settings_dialog.dart): `lib/settings_dialog.dart`
- [Audio manager](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/audio_manager.dart): `lib/audio_manager.dart`
- [Audio assets](https://github.com/zaintahir2025/flappy-bird/tree/main/assets/audio): `assets/audio`

### Local persistence

- [Storage facade](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage.dart): `lib/score_storage.dart`
- [Native storage](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_io.dart): `lib/score_storage_io.dart`
- [Web storage](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_web.dart): `lib/score_storage_web.dart`
- [Storage contract](https://github.com/zaintahir2025/flappy-bird/blob/main/lib/score_storage_stub.dart): `lib/score_storage_stub.dart`

### Platform hosting

- [Windows runner](https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Flutter window host](https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Windows entry](https://github.com/zaintahir2025/flappy-bird/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Linux application host](https://github.com/zaintahir2025/flappy-bird/blob/main/linux/my_application.cc): `linux/my_application.cc`
- [Linux plugin registration](https://github.com/zaintahir2025/flappy-bird/blob/main/linux/flutter/generated_plugin_registrant.cc): `linux/flutter/generated_plugin_registrant.cc`
- [iOS app delegate](https://github.com/zaintahir2025/flappy-bird/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`
- [macOS plugin registration](https://github.com/zaintahir2025/flappy-bird/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`

### Other components

- **Player**

## Connections

- Player → App entry: opens (evidence: `README.md`)
- App entry → Game loop and HUD: starts game (evidence: `README.md`)
- Player → Game loop and HUD: controls flight (evidence: `README.md`)
- Game loop and HUD → Bird and flight: renders flyer (evidence: `README.md`)
- Game loop and HUD → Biome obstacles: renders obstacles (evidence: `README.md`)
- Game loop and HUD → Game models: uses game data (evidence: `README.md`)
- Game loop and HUD → Particle effects: shows effects
- Game loop and HUD → World selection: opens selector (evidence: `README.md`)
- Game loop and HUD → Skin shop: opens shop (evidence: `README.md`)
- Game loop and HUD → Quest challenges: opens quests (evidence: `README.md`)
- Game loop and HUD → Leaderboard dialog: opens rankings (evidence: `README.md`)
- Game loop and HUD → Settings: opens settings (evidence: `README.md`)
- Game loop and HUD → Pilot callsign: requests callsign (evidence: `README.md`)
- Leaderboard dialog → Career data: shows career stats (evidence: `README.md`)
- Game loop and HUD → Career data: tracks career (evidence: `README.md`)
- Settings → Audio manager: configures sound (evidence: `README.md`)
- Audio manager → Audio assets: plays audio (evidence: `README.md`)
- Game loop and HUD → Storage facade: persists scores (evidence: `README.md`)
- Storage facade → Native storage: selects native (evidence: `README.md`)
- Storage facade → Web storage: selects web (evidence: `README.md`)
- Storage facade → Storage contract: uses contract (evidence: `README.md`)
- Windows entry → Flutter window host: creates window (evidence: `windows/runner/main.cpp`)
- Flutter window host → Windows runner: inherits window
- Linux application host → Linux plugin registration: registers plugins
- iOS app delegate → macOS plugin registration: registers plugins (evidence: `ios/Runner/AppDelegate.swift`)
