# Scenes Index This file is the canonical client flow map. Scene details live in `context-files/scenes/*.scene.md`. ## Core Lifecycle Flow 1. `ClientLaunch` -> `scenes/client-launch.scene.md` 2. `Login` -> `scenes/login.scene.md` 3. `Register` (from Login) -> `scenes/register.scene.md` 4. `MainMenu` (post-auth hub) -> `scenes/main-menu.scene.md` Flow rules: - `ClientLaunch` must complete update check before opening auth flow. - `Login` owns initial connection/session probe and transitions to `MainMenu` only after auth success. - `Register` returns to `Login` (or direct session bootstrap if server returns tokens). ## Main Menu Navigation Map Primary destinations: 1. `RankedPlay` (ranked lobby + matchmaking) -> `scenes/ranked-play.scene.md` 2. `CustomPlay` (unranked/custom lobby) -> `scenes/custom-play.scene.md` 3. `Bazaar` -> `scenes/bazaar.scene.md` 4. `Leaderboard` -> `scenes/leaderboard.scene.md` 5. `CollectionHub` -> `scenes/collection-hub.scene.md` 6. `AccountManagement` -> `scenes/account-management.scene.md` 7. `Settings` -> `scenes/settings.scene.md` Collection subtree: 1. `DeckEditor` -> `scenes/deck-editor.scene.md` 2. `CardViewer` -> `scenes/card-viewer.scene.md` 3. `Cosmetics` -> `scenes/cosmetics.scene.md` ## Cross-Scene UI Requirements - Persistent quick actions: `Settings` and `Report Bug` in all scenes. - Main social/chat panel channels: `System`, `General`, `Friends`. - Friend actions available where identity is visible: `Add Friend`, `Remove Friend`, `Block`. - Ranked/unranked lobby-specific chat sections appear only while inside those lobbies. ## Global Rules - Shared/global client rules are in `global.md`.