# vichally20/ouroborous architecture

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

- Interactive diagram: https://gitdiagram.com/vichally20/ouroborous
- Repository: https://github.com/vichally20/ouroborous

## Overview

1. **Overall shape**
   - This is a **cross-platform Flutter app** with a game-like structure, not a traditional client/server app.
   - The core logic lives in `lib/`; the `android/`, `ios/`, `web/`, `macos/`, `windows/`, and `linux/` folders are platform runners and packaging layers.

2. **App entry and shell**
   - `lib/main.dart` is the entrypoint into the Flutter app.
   - The app likely starts into a hub/intro flow and then routes into gameplay, inventory, navigation, and other screens through the state layer.

3. **Presentation layer**
   - `lib/ui/screens/` contains the main user-facing screens: `intro`, `game_hub`, `you_hub`, `chronicle`, `combat`, `inventory`, `navigation`, `persona`, `stats`, `talents`, and `settings`.
   - `lib/ui/widgets/` provides reusable UI primitives such as `etched_container` and `manuscript_controls`.
   - `lib/core/theme/` and `lib/core/constants/` define the visual system (`manuscript_theme`, colors, typography), which suggests a consistent stylized UI across screens.

4. **Game runtime layer**
   - `lib/game/` is the real-time gameplay subsystem.
   - `city_game.dart` appears to be the main game runtime container.
   - `components/` includes runtime entities like `player`, `enemy`, `projectile`, and `infinite_background_art`, plus `hud_overlay` for game UI layered over the playfield.
   - This layer is responsible for moment-to-moment play and likely drives combat and exploration visuals separately from the standard Flutter screen stack.

5. **Story and content engine**
   - `lib/game/story_engine.dart` is the narrative orchestration layer.
   - It consumes bundled content from `assets/story/` and `assets/data/`, including chapter JSON, bestiary, encounters, weapons lore, and ancient lore.
   - This indicates a **content-driven architecture**: story progression and world data are externalized into assets rather than hardcoded in UI.

6. **Domain model layer**
   - `lib/models/` holds the shared game schema: character, combat, story, inventory, skills, loadouts, vitals, talents, perks, and attributes.
   - These models form the boundary between narrative/game logic and presentation.
   - The same model types are reused by state managers, the story engine, and the gameplay runtime, which keeps screens thin and data-driven.

7. **State and coordination layer**
   - `lib/states/` contains the application controllers: `game_controller`, `combat_state`, `inventory_state`, `navigation_state`, `player_state`, and `settings_state`.
   - This is the orchestration boundary that coordinates screen transitions, player progression, combat state, and preferences.
   - The naming suggests a centralized app state approach where UI and runtime components read from and react to these state objects.

8. **Feature partitioning**
   - `lib/sandbox/` is a separate experimental or isolated gameplay area with its own `sandbox_launcher`, `sandbox_dungeon_screen`, and `sandbox_dungeon_controller`.
   - This looks like a self-contained testbed for dungeon mechanics or combat systems, separate from the main progression loop.
   - In an architecture diagram, it should be shown as a secondary feature area branching off the main app flow.

9. **Primary data flow**
   - Bundled JSON assets feed the story engine and model layer.
   - The state layer transforms those domain objects into app state.
   - Screens render that state and dispatch user actions back into controllers.
   - The game runtime uses the same underlying models but presents them through a real-time interactive layer, with HUD overlays and gameplay components.

10. **Platform boundaries**
   - The native folders are standard Flutter host projects, not feature logic.
   - Android/iOS/macOS/Windows/Linux/Web exist to launch the same Dart application with platform-specific bootstrapping, icons, manifests, and build settings.
   - There is no evidence of a backend, database, or remote API; the architecture is primarily **local, asset-backed, and client-only**.

11. **Supporting docs and tests**
   - `docs/PRD.md` and `features.md` provide product/feature context.
   - `test/widget_test.dart` and the platform test targets are minimal, suggesting the project is still early-stage or scaffolded.

12. **How to draw it**
   - A good diagram would show: **platform shell → app entry → state/controllers → screens/game runtime → shared models → bundled assets**.
   - The sandbox should be drawn as a parallel feature branch.
   - Theme/constants sit beside the UI layer, while story/data assets feed both the story engine and gameplay systems.

Main entry points: [`lib/states/game_controller.dart`](https://github.com/vichally20/ouroborous/blob/main/lib/states/game_controller.dart) (Game ctrl), [`lib/game/city_game.dart`](https://github.com/vichally20/ouroborous/blob/main/lib/game/city_game.dart) (City game), [`lib/ui/screens/game_hub_screen.dart`](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/game_hub_screen.dart) (Game hub), [`lib/game/story_engine.dart`](https://github.com/vichally20/ouroborous/blob/main/lib/game/story_engine.dart) (Story engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Platform runners"]
  node_android_runner["Android<br/>platform host<br/>[MainActivity.kt]"]
  node_ios_runner["iOS<br/>platform host<br/>[AppDelegate.swift]"]
  node_macos_runner["macOS<br/>platform host<br/>[AppDelegate.swift]"]
end

subgraph group_app["App core"]
  node_lib_main(("Main<br/>Flutter entrypoint<br/>[main.dart]"))
  node_theme["Theme<br/>UI system"]
  node_colors["Colors<br/>palette<br/>[colors.dart]"]
  node_typography["Typography<br/>text styles<br/>[typography.dart]"]
  node_game_controller["Game ctrl<br/>app coordinator"]
  node_combat_state["Combat state<br/>state controller<br/>[combat_state.dart]"]
  node_inventory_state["Inventory<br/>state controller"]
  node_navigation_state["Navigation<br/>state controller"]
  node_player_state["Player state<br/>state controller<br/>[player_state.dart]"]
  node_settings_state["Settings<br/>state controller"]
  node_models["Models<br/>domain schema<br/>[story_models.dart]"]
end

subgraph group_ui["Presentation"]
  node_intro["Intro<br/>screen<br/>[intro_screen.dart]"]
  node_game_hub["Game hub<br/>screen"]
  node_you_hub["You hub<br/>screen"]
  node_combat_screen["Combat<br/>screen<br/>[combat_screen.dart]"]
  node_inventory_screen["Inventory<br/>screen"]
  node_navigation_screen["Navigation<br/>screen"]
end

subgraph group_game["Game runtime"]
  node_hud_overlay["HUD<br/>game overlay<br/>[hud_overlay.dart]"]
  node_city_game["City game<br/>runtime shell<br/>[city_game.dart]"]
  node_player(("Player<br/>entity<br/>[player.dart]"))
  node_enemy(("Enemy<br/>entity<br/>[enemy.dart]"))
  node_projectile(("Projectile<br/>entity<br/>[projectile.dart]"))
  node_background["Background<br/>visual layer"]
end

subgraph group_content["Content"]
  node_story_engine["Story engine<br/>narrative orchestrator<br/>[story_engine.dart]"]
  node_chapter_1["Chapter 1<br/>story asset<br/>[chapter_1.json]"]
  node_chapter_2["Chapter 2<br/>story asset<br/>[chapter_2.json]"]
  node_bestiary["Bestiary<br/>data asset<br/>[bestiary.json]"]
  node_encounters["Encounters<br/>data asset<br/>[encounters.json]"]
end

subgraph group_sandbox["Sandbox"]
  node_sandbox_launcher["Sandbox launch<br/>feature entry"]
  node_sandbox_screen["Sandbox dungeon<br/>screen"]
  node_sandbox_controller["Sandbox ctrl<br/>feature controller"]
end

node_lib_main -->|"boots"| node_game_controller
node_game_controller -->|"routes to"| node_intro
node_game_controller -->|"routes to"| node_game_hub
node_game_controller -->|"owns"| node_combat_state
node_game_controller -->|"owns"| node_inventory_state
node_game_controller -->|"owns"| node_navigation_state
node_game_controller -->|"owns"| node_player_state
node_game_controller -->|"owns"| node_settings_state
node_game_controller -->|"uses"| node_story_engine
node_intro -->|"advances to"| node_game_hub
node_game_hub -->|"opens"| node_you_hub
node_game_hub -->|"opens"| node_combat_screen
node_game_hub -->|"opens"| node_inventory_screen
node_game_hub -->|"opens"| node_navigation_screen
node_combat_screen -->|"reads"| node_combat_state
node_inventory_screen -->|"reads"| node_inventory_state
node_navigation_screen -->|"reads"| node_navigation_state
node_you_hub -->|"reads"| node_player_state
node_combat_state -->|"uses"| node_models
node_inventory_state -->|"uses"| node_models
node_navigation_state -->|"uses"| node_models
node_player_state -->|"uses"| node_models
node_story_engine -->|"loads"| node_chapter_1
node_story_engine -->|"loads"| node_chapter_2
node_story_engine -->|"loads"| node_bestiary
node_story_engine -->|"loads"| node_encounters
node_city_game -->|"spawns"| node_player
node_city_game -->|"spawns"| node_enemy
node_city_game -->|"spawns"| node_projectile
node_city_game -->|"layers"| node_background
node_city_game -->|"overlays"| node_hud_overlay
node_city_game -->|"uses"| node_models
node_sandbox_launcher -->|"starts"| node_sandbox_controller
node_sandbox_launcher -->|"opens"| node_sandbox_screen
node_sandbox_controller -->|"uses"| node_models
node_theme -->|"includes"| node_colors
node_theme -->|"includes"| node_typography
node_intro -->|"styles with"| node_theme
node_game_hub -->|"styles with"| node_theme
node_combat_screen -->|"styles with"| node_theme
node_city_game -->|"syncs with"| node_story_engine
node_android_runner -->|"launches"| node_lib_main
node_ios_runner -->|"launches"| node_lib_main
node_macos_runner -->|"launches"| node_lib_main

click node_lib_main "https://github.com/vichally20/ouroborous/blob/main/lib/main.dart"
click node_theme "https://github.com/vichally20/ouroborous/blob/main/lib/core/theme/manuscript_theme.dart"
click node_colors "https://github.com/vichally20/ouroborous/blob/main/lib/core/constants/colors.dart"
click node_typography "https://github.com/vichally20/ouroborous/blob/main/lib/core/constants/typography.dart"
click node_game_controller "https://github.com/vichally20/ouroborous/blob/main/lib/states/game_controller.dart"
click node_combat_state "https://github.com/vichally20/ouroborous/blob/main/lib/states/combat_state.dart"
click node_inventory_state "https://github.com/vichally20/ouroborous/blob/main/lib/states/inventory_state.dart"
click node_navigation_state "https://github.com/vichally20/ouroborous/blob/main/lib/states/navigation_state.dart"
click node_player_state "https://github.com/vichally20/ouroborous/blob/main/lib/states/player_state.dart"
click node_settings_state "https://github.com/vichally20/ouroborous/blob/main/lib/states/settings_state.dart"
click node_models "https://github.com/vichally20/ouroborous/blob/main/lib/models/story_models.dart"
click node_intro "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/intro_screen.dart"
click node_game_hub "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/game_hub_screen.dart"
click node_you_hub "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/you_hub_screen.dart"
click node_combat_screen "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/combat_screen.dart"
click node_inventory_screen "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/inventory_screen.dart"
click node_navigation_screen "https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/navigation_screen.dart"
click node_hud_overlay "https://github.com/vichally20/ouroborous/blob/main/lib/game/ui/hud_overlay.dart"
click node_city_game "https://github.com/vichally20/ouroborous/blob/main/lib/game/city_game.dart"
click node_player "https://github.com/vichally20/ouroborous/blob/main/lib/game/components/player.dart"
click node_enemy "https://github.com/vichally20/ouroborous/blob/main/lib/game/components/enemy.dart"
click node_projectile "https://github.com/vichally20/ouroborous/blob/main/lib/game/components/projectile.dart"
click node_background "https://github.com/vichally20/ouroborous/blob/main/lib/game/components/infinite_background_art.dart"
click node_story_engine "https://github.com/vichally20/ouroborous/blob/main/lib/game/story_engine.dart"
click node_chapter_1 "https://github.com/vichally20/ouroborous/blob/main/assets/story/chapter_1.json"
click node_chapter_2 "https://github.com/vichally20/ouroborous/blob/main/assets/story/chapter_2.json"
click node_bestiary "https://github.com/vichally20/ouroborous/blob/main/assets/data/bestiary.json"
click node_encounters "https://github.com/vichally20/ouroborous/blob/main/assets/data/encounters.json"
click node_sandbox_launcher "https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_launcher.dart"
click node_sandbox_screen "https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_dungeon_screen.dart"
click node_sandbox_controller "https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_dungeon_controller.dart"
click node_android_runner "https://github.com/vichally20/ouroborous/blob/main/android/app/src/main/kotlin/com/example/ouroboros/MainActivity.kt"
click node_ios_runner "https://github.com/vichally20/ouroborous/blob/main/ios/Runner/AppDelegate.swift"
click node_macos_runner "https://github.com/vichally20/ouroborous/blob/main/macos/Runner/AppDelegate.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_android_runner,node_ios_runner,node_macos_runner toneBlue
class node_lib_main,node_theme,node_colors,node_typography,node_game_controller,node_combat_state,node_inventory_state,node_navigation_state,node_player_state,node_settings_state,node_models toneAmber
class node_intro,node_game_hub,node_you_hub,node_combat_screen,node_inventory_screen,node_navigation_screen toneMint
class node_hud_overlay,node_city_game,node_player,node_enemy,node_projectile,node_background toneRose
class node_story_engine,node_chapter_1,node_chapter_2,node_bestiary,node_encounters toneIndigo
class node_sandbox_launcher,node_sandbox_screen,node_sandbox_controller toneTeal
```

## Components

### Platform runners

Flutter host projects and packaging layers for each target platform.

- [Android](https://github.com/vichally20/ouroborous/blob/main/android/app/src/main/kotlin/com/example/ouroboros/MainActivity.kt): platform host · Android Flutter host and packaging layer. · `android/app/src/main/kotlin/com/example/ouroboros/MainActivity.kt`
- [iOS](https://github.com/vichally20/ouroborous/blob/main/ios/Runner/AppDelegate.swift): platform host · iOS Flutter host and packaging layer. · `ios/Runner/AppDelegate.swift`
- [macOS](https://github.com/vichally20/ouroborous/blob/main/macos/Runner/AppDelegate.swift): platform host · macOS Flutter host and packaging layer. · `macos/Runner/AppDelegate.swift`

### App core

Entry point, shared theme, state, and domain models.

- [Main](https://github.com/vichally20/ouroborous/blob/main/lib/main.dart): Flutter entrypoint · Starts the Flutter app and hands off to the app shell. · `lib/main.dart`
- [Theme](https://github.com/vichally20/ouroborous/blob/main/lib/core/theme/manuscript_theme.dart): UI system · Shared visual styling and manuscript theme. · `lib/core/theme/manuscript_theme.dart`
- [Colors](https://github.com/vichally20/ouroborous/blob/main/lib/core/constants/colors.dart): palette · Core color constants used by the visual system. · `lib/core/constants/colors.dart`
- [Typography](https://github.com/vichally20/ouroborous/blob/main/lib/core/constants/typography.dart): text styles · Shared text styling constants. · `lib/core/constants/typography.dart`
- [Game ctrl](https://github.com/vichally20/ouroborous/blob/main/lib/states/game_controller.dart): app coordinator · Coordinates high-level app flow and game progression. · `lib/states/game_controller.dart`
- [Combat state](https://github.com/vichally20/ouroborous/blob/main/lib/states/combat_state.dart): state controller · Tracks combat flow and outcomes. · `lib/states/combat_state.dart`
- [Inventory](https://github.com/vichally20/ouroborous/blob/main/lib/states/inventory_state.dart): state controller · Manages inventory and item-related state. · `lib/states/inventory_state.dart`
- [Navigation](https://github.com/vichally20/ouroborous/blob/main/lib/states/navigation_state.dart): state controller · Coordinates map and movement-related state. · `lib/states/navigation_state.dart`
- [Player state](https://github.com/vichally20/ouroborous/blob/main/lib/states/player_state.dart): state controller · Holds player progression and character state. · `lib/states/player_state.dart`
- [Settings](https://github.com/vichally20/ouroborous/blob/main/lib/states/settings_state.dart): state controller · Stores user preferences and app settings. · `lib/states/settings_state.dart`
- [Models](https://github.com/vichally20/ouroborous/blob/main/lib/models/story_models.dart): domain schema · Shared game data types reused across UI, state, and runtime. · `lib/models/story_models.dart`

### Presentation

User-facing screens and reusable widgets.

- [Intro](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/intro_screen.dart): screen · Entry and onboarding flow. · `lib/ui/screens/intro_screen.dart`
- [Game hub](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/game_hub_screen.dart): screen · Primary hub for progression and mode selection. · `lib/ui/screens/game_hub_screen.dart`
- [You hub](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/you_hub_screen.dart): screen · Character-centric hub and profile area. · `lib/ui/screens/you_hub_screen.dart`
- [Combat](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/combat_screen.dart): screen · Turn or encounter-facing combat presentation. · `lib/ui/screens/combat_screen.dart`
- [Inventory](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/inventory_screen.dart): screen · Inventory browsing and item management UI. · `lib/ui/screens/inventory_screen.dart`
- [Navigation](https://github.com/vichally20/ouroborous/blob/main/lib/ui/screens/navigation_screen.dart): screen · Route and location selection UI. · `lib/ui/screens/navigation_screen.dart`

### Game runtime

Real-time gameplay loop and runtime entities.

- [HUD](https://github.com/vichally20/ouroborous/blob/main/lib/game/ui/hud_overlay.dart): game overlay · In-game heads-up UI layered over gameplay. · `lib/game/ui/hud_overlay.dart`
- [City game](https://github.com/vichally20/ouroborous/blob/main/lib/game/city_game.dart): runtime shell · Main real-time game container and loop. · `lib/game/city_game.dart`
- [Player](https://github.com/vichally20/ouroborous/blob/main/lib/game/components/player.dart): entity · Runtime player entity. · `lib/game/components/player.dart`
- [Enemy](https://github.com/vichally20/ouroborous/blob/main/lib/game/components/enemy.dart): entity · Runtime hostile entity. · `lib/game/components/enemy.dart`
- [Projectile](https://github.com/vichally20/ouroborous/blob/main/lib/game/components/projectile.dart): entity · Runtime attack or effect entity. · `lib/game/components/projectile.dart`
- [Background](https://github.com/vichally20/ouroborous/blob/main/lib/game/components/infinite_background_art.dart): visual layer · Scrollable or infinite background art layer. · `lib/game/components/infinite_background_art.dart`

### Content

Bundled narrative and world data assets.

- [Story engine](https://github.com/vichally20/ouroborous/blob/main/lib/game/story_engine.dart): narrative orchestrator · Loads and advances narrative content from assets. · `lib/game/story_engine.dart`
- [Chapter 1](https://github.com/vichally20/ouroborous/blob/main/assets/story/chapter_1.json): story asset · Bundled chapter content. · `assets/story/chapter_1.json`
- [Chapter 2](https://github.com/vichally20/ouroborous/blob/main/assets/story/chapter_2.json): story asset · Bundled chapter content. · `assets/story/chapter_2.json`
- [Bestiary](https://github.com/vichally20/ouroborous/blob/main/assets/data/bestiary.json): data asset · Creature and enemy reference data. · `assets/data/bestiary.json`
- [Encounters](https://github.com/vichally20/ouroborous/blob/main/assets/data/encounters.json): data asset · Encounter tables and scenario data. · `assets/data/encounters.json`

### Sandbox

Isolated experimental gameplay branch.

- [Sandbox launch](https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_launcher.dart): feature entry · Entry point for the isolated sandbox feature. · `lib/sandbox/sandbox_launcher.dart`
- [Sandbox dungeon](https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_dungeon_screen.dart): screen · Sandbox dungeon play screen. · `lib/sandbox/sandbox_dungeon_screen.dart`
- [Sandbox ctrl](https://github.com/vichally20/ouroborous/blob/main/lib/sandbox/sandbox_dungeon_controller.dart): feature controller · Controller for sandbox dungeon flow. · `lib/sandbox/sandbox_dungeon_controller.dart`

## Connections

- Main → Game ctrl: boots · App entry initializes the main app controller.
- Game ctrl → Intro: routes to · High-level state drives the first user-facing flow.
- Game ctrl → Game hub: routes to · Main hub is the central navigation destination.
- Game ctrl → Combat state: owns · Coordinates combat-related application state.
- Game ctrl → Inventory: owns · Coordinates inventory-related application state.
- Game ctrl → Navigation: owns · Coordinates map and movement state.
- Game ctrl → Player state: owns · Coordinates player progression state.
- Game ctrl → Settings: owns · Coordinates preference state.
- Game ctrl → Story engine: uses · App flow consumes narrative progression.
- Intro → Game hub: advances to · Intro flow leads into the hub.
- Game hub → You hub: opens · Hub branches into character-centric views.
- Game hub → Combat: opens · Hub can enter combat presentation.
- Game hub → Inventory: opens · Hub can enter inventory management.
- Game hub → Navigation: opens · Hub can enter navigation flow.
- Combat → Combat state: reads · Combat UI reflects combat controller state.
- Inventory → Inventory: reads · Inventory UI reflects inventory controller state.
- Navigation → Navigation: reads · Navigation UI reflects navigation controller state.
- You hub → Player state: reads · Character hub reflects player progression.
- Combat state → Models: uses · Combat logic relies on shared domain types.
- Inventory → Models: uses · Inventory logic relies on shared domain types.
- Navigation → Models: uses · Navigation logic relies on shared domain types.
- Player state → Models: uses · Player progression is modeled with shared schema.
- Story engine → Chapter 1: loads · Narrative engine consumes chapter assets.
- Story engine → Chapter 2: loads · Narrative engine consumes chapter assets.
- Story engine → Bestiary: loads · Story and encounter logic uses content data.
- Story engine → Encounters: loads · Story and encounter logic uses content data.
- City game → Player: spawns · Main runtime instantiates player entity.
- City game → Enemy: spawns · Main runtime instantiates hostile entities.
- City game → Projectile: spawns · Main runtime manages projectile entities.
- City game → Background: layers · Gameplay uses a background art layer.
- City game → HUD: overlays · HUD is layered over the playfield.
- City game → Models: uses · Gameplay entities and runtime state use shared models.
- Sandbox launch → Sandbox ctrl: starts · Sandbox entry wires up its controller.
- Sandbox launch → Sandbox dungeon: opens · Sandbox entry opens the dungeon screen.
- Sandbox ctrl → Models: uses · Sandbox mechanics reuse shared domain types.
- Theme → Colors: includes · Theme builds on shared palette constants.
- Theme → Typography: includes · Theme builds on shared typography constants.
- Intro → Theme: styles with · Screens use the shared visual system.
- Game hub → Theme: styles with · Screens use the shared visual system.
- Combat → Theme: styles with · Screens use the shared visual system.
- City game → Story engine: syncs with · Real-time play consumes narrative/content state.
- Android → Main: launches · Platform host boots the Flutter entrypoint.
- iOS → Main: launches · Platform host boots the Flutter entrypoint.
- macOS → Main: launches · Platform host boots the Flutter entrypoint.
