# gireeshkumarreddy/gta6-leonida-website architecture

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

- Interactive diagram: https://gitdiagram.com/gireeshkumarreddy/gta6-leonida-website
- Repository: https://github.com/gireeshkumarreddy/gta6-leonida-website

## Overview

This is a React-based interactive promotional experience, organized as a scrollable story of chapters with launch countdown, world and character showcases, gameplay/media, and interactive overlays. The user enters through the app shell, which initializes settings and interaction services before presenting the chapter experience and HUD. Supporting layers provide shared state, media resolution, audio, WebGL scenes, and game-style interactions. The README is empty; relationships below are limited to those visible in excerpts or documented in the source index, so some capabilities are represented without speculative connections.

Main entry points: [`src/App.tsx`](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/App.tsx) (App Shell), [`src/game/switch.tsx`](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/switch.tsx) (Satellite Switch), [`src/ui/media.tsx`](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/ui/media.tsx) (Media Components), [`src/chapters`](https://github.com/gireeshkumarreddy/gta6-leonida-website/tree/main/src/chapters) (Story Chapters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Story Experience"]
  node_app["App Shell<br/>[App.tsx]"]
  node_chapters["Story Chapters"]
  node_hero["Hero Scene<br/>[Hero.tsx]"]
end

subgraph group_interaction["Game Interactions"]
  node_hud["HUD and Toasts<br/>[hud.tsx]"]
  node_overlays["Menus and Overlays<br/>[overlays.tsx]"]
  node_satellite["Satellite Switch<br/>[switch.tsx]"]
  node_cheats["Secrets and Cheats<br/>[cheats.ts]"]
  node_gamepad["Gamepad Controls<br/>[gamepad.ts]"]
  node_respray["Respray<br/>[respray.ts]"]
  node_sharing["Share Export<br/>[share.ts]"]
end

subgraph group_content["Content and Media"]
  node_mediaui["Media Components<br/>[media.tsx]"]
  node_media["Media Catalog<br/>[media.ts]"]
  node_world["World and Trailers<br/>[world.ts]"]
  node_cast["Character Data<br/>[cast.ts]"]
  node_loadout["Loadout Data<br/>[loadout.ts]"]
end

subgraph group_runtime["Runtime Systems"]
  node_scroll["Scroll Control<br/>[scroll.ts]"]
  node_state["Game State<br/>[store.ts]"]
  node_audio["Audio Engine<br/>[engine.ts]"]
  node_webgl["WebGL Scenes"]
  node_quality["Quality Detection<br/>[quality.ts]"]
  node_effects["Reveal Effects<br/>[fx.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"renders"| node_chapters
node_app -->|"mounts"| node_hud
node_app -->|"mounts"| node_overlays
node_app -->|"mounts"| node_satellite
node_app -->|"initializes"| node_state
node_app -->|"starts"| node_scroll
node_app -->|"starts listener"| node_cheats
node_app -->|"starts"| node_gamepad
node_app -->|"detects quality"| node_quality
node_app -->|"starts reveals"| node_effects
node_chapters -->|"includes"| node_hero
node_overlays -->|"exports canvas"| node_sharing
node_respray -->|"uses export"| node_sharing
node_satellite -->|"scrolls to"| node_scroll
node_satellite -->|"resolves shots"| node_media
node_mediaui -->|"resolves assets"| node_media
node_mediaui -->|"reads settings"| node_state
node_hero -->|"selects scene quality"| node_quality

click node_app "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/App.tsx"
click node_chapters "https://github.com/gireeshkumarreddy/gta6-leonida-website/tree/main/src/chapters"
click node_hero "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/chapters/Hero.tsx"
click node_hud "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/hud.tsx"
click node_overlays "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/overlays.tsx"
click node_satellite "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/switch.tsx"
click node_cheats "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/cheats.ts"
click node_gamepad "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/gamepad.ts"
click node_respray "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/respray.ts"
click node_sharing "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/share.ts"
click node_scroll "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/scroll.ts"
click node_state "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/store.ts"
click node_audio "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/audio/engine.ts"
click node_webgl "https://github.com/gireeshkumarreddy/gta6-leonida-website/tree/main/src/gl"
click node_quality "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/gl/quality.ts"
click node_effects "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/ui/fx.ts"
click node_mediaui "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/ui/media.tsx"
click node_media "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/media.ts"
click node_world "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/world.ts"
click node_cast "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/cast.ts"
click node_loadout "https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/loadout.ts"

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_app,node_chapters,node_hero toneBlue
class node_hud,node_overlays,node_satellite,node_cheats,node_gamepad,node_respray,node_sharing toneAmber
class node_mediaui,node_media,node_world,node_cast,node_loadout toneMint
class node_scroll,node_state,node_audio,node_webgl,node_quality,node_effects toneRose
class node_visitor toneIndigo
```

## Components

### Story Experience

- [App Shell](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/App.tsx): `src/App.tsx`
- [Story Chapters](https://github.com/gireeshkumarreddy/gta6-leonida-website/tree/main/src/chapters): `src/chapters`
- [Hero Scene](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/chapters/Hero.tsx): `src/chapters/Hero.tsx`

### Game Interactions

- [HUD and Toasts](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/hud.tsx): `src/game/hud.tsx`
- [Menus and Overlays](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/overlays.tsx): `src/game/overlays.tsx`
- [Satellite Switch](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/switch.tsx): `src/game/switch.tsx`
- [Secrets and Cheats](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/cheats.ts): `src/game/cheats.ts`
- [Gamepad Controls](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/gamepad.ts): `src/game/gamepad.ts`
- [Respray](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/respray.ts): `src/game/respray.ts`
- [Share Export](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/share.ts): `src/game/share.ts`

### Content and Media

- [Media Components](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/ui/media.tsx): `src/ui/media.tsx`
- [Media Catalog](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/media.ts): `src/content/media.ts`
- [World and Trailers](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/world.ts): `src/content/world.ts`
- [Character Data](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/cast.ts): `src/content/cast.ts`
- [Loadout Data](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/content/loadout.ts): `src/content/loadout.ts`

### Runtime Systems

- [Scroll Control](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/scroll.ts): `src/game/scroll.ts`
- [Game State](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/game/store.ts): `src/game/store.ts`
- [Audio Engine](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/audio/engine.ts): `src/audio/engine.ts`
- [WebGL Scenes](https://github.com/gireeshkumarreddy/gta6-leonida-website/tree/main/src/gl): `src/gl`
- [Quality Detection](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/gl/quality.ts): `src/gl/quality.ts`
- [Reveal Effects](https://github.com/gireeshkumarreddy/gta6-leonida-website/blob/main/src/ui/fx.ts): `src/ui/fx.ts`

### Other components

- **Visitor**

## Connections

- Visitor → App Shell: opens
- App Shell → Story Chapters: renders (evidence: `src/App.tsx`)
- App Shell → HUD and Toasts: mounts (evidence: `src/App.tsx`)
- App Shell → Menus and Overlays: mounts (evidence: `src/App.tsx`)
- App Shell → Satellite Switch: mounts (evidence: `src/App.tsx`)
- App Shell → Game State: initializes (evidence: `src/App.tsx`)
- App Shell → Scroll Control: starts (evidence: `src/App.tsx`)
- App Shell → Secrets and Cheats: starts listener (evidence: `src/App.tsx`)
- App Shell → Gamepad Controls: starts (evidence: `src/App.tsx`)
- App Shell → Quality Detection: detects quality (evidence: `src/App.tsx`)
- App Shell → Reveal Effects: starts reveals (evidence: `src/App.tsx`)
- Story Chapters → Hero Scene: includes (evidence: `src/App.tsx`)
- Menus and Overlays → Share Export: exports canvas (evidence: `src/game/overlays.tsx`)
- Respray → Share Export: uses export (evidence: `src/game/respray.ts`)
- Satellite Switch → Scroll Control: scrolls to (evidence: `src/game/switch.tsx`)
- Satellite Switch → Media Catalog: resolves shots (evidence: `src/game/switch.tsx`)
- Media Components → Media Catalog: resolves assets (evidence: `src/ui/media.tsx`)
- Media Components → Game State: reads settings (evidence: `src/ui/media.tsx`)
- Hero Scene → Quality Detection: selects scene quality (evidence: `src/chapters/Hero.tsx`)
