# ye4hl0w/gamesonweb architecture

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

- Interactive diagram: https://gitdiagram.com/ye4hl0w/gamesonweb
- Repository: https://github.com/ye4hl0w/gamesonweb

## Overview

GamesOnWeb is a browser portal for a three-game narrative trilogy. Players enter through the portal, select a game, play its levels, and can view account-linked cross-game progress saved in browser storage. The games use distinct runtimes: DOM-based Awakening, Canvas-based Shadow Travelers, and BabylonJS-based Dream Travelers. The graph preserves the documented portal and gameplay subsystems; some detailed game-internal links are omitted because their source was not sampled.

Main entry points: [`ShadowTravelers/js/levels`](https://github.com/ye4hl0w/gamesonweb/tree/main/ShadowTravelers/js/levels) (Shadow levels), [`TheAwakening/js/game.js`](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/game.js) (DOM game loop), [`index.js`](https://github.com/ye4hl0w/gamesonweb/blob/main/index.js) (Section loader), [`ShadowTravelers/js/levels/BaseLevel.js`](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/levels/BaseLevel.js) (Shared level runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Portal"]
  node_portal_ui["Portal interface<br/>[index.html]"]
  node_portal_router["Section loader<br/>[index.js]"]
  node_home["Home section<br/>[home.js]"]
  node_login["Sign-in<br/>[connexion.js]"]
  node_progress_view["Progress view<br/>[progress.js]"]
  node_progress_store["Progress storage<br/>[gameProgress.js]"]
end

subgraph group_awakening["The Awakening"]
  node_awakening_page["Awakening entry<br/>[index.html]"]
  node_awakening_game["DOM game loop<br/>[game.js]"]
  node_awakening_controls["Controls<br/>[controls.js]"]
  node_awakening_physics["Physics<br/>[physics.js]"]
  node_awakening_ui["Game UI<br/>[ui.js]"]
  node_awakening_levels["Tutorial and levels"]
  node_awakening_manager["Level manager<br/>[levelManager.js]"]
end

subgraph group_shadow["Shadow Travelers"]
  node_shadow_page["Shadow entry<br/>[index.html]"]
  node_shadow_manager["Canvas level manager<br/>[levelManager.js]"]
  node_shadow_levels["Shadow levels"]
  node_shadow_base["Shared level runtime<br/>[BaseLevel.js]"]
  node_shadow_player["Player character<br/>[Player.js]"]
  node_shadow_ghost["Ghost dialogue<br/>[Ghost.js]"]
  node_shadow_pnj["Character base<br/>[PNJ.js]"]
  node_shadow_guardian["Guardian enemy<br/>[Guardian.js]"]
  node_shadow_obstacles["Obstacles and hazards"]
  node_shadow_exit["Exit portal<br/>[Exit.js]"]
  node_shadow_zone["Shadow zones<br/>[ShadowZone.js]"]
end

subgraph group_dream["Dream Travelers"]
  node_dream_page["Dream entry<br/>[index.html]"]
  node_dream_menu["Level selection<br/>[index.js]"]
  node_dream_levels["3D level layouts"]
  node_dream_base["3D level runtime<br/>[BaseLevel.js]"]
  node_dream_player["Pathfinding player<br/>[Player.js]"]
  node_dream_elements["World elements"]
end

node_player(("Player"))
node_browser_storage[("Browser localStorage")]

node_player -->|"opens"| node_portal_ui
node_portal_ui -->|"starts"| node_portal_router
node_portal_router -->|"loads sections"| node_home
node_portal_router -->|"loads sections"| node_login
node_portal_router -->|"loads sections"| node_progress_view
node_player -->|"signs in"| node_login
node_login -->|"stores session"| node_browser_storage
node_progress_view -->|"displays progress"| node_progress_store
node_progress_store -->|"reads and writes"| node_browser_storage
node_player -->|"opens game"| node_awakening_page
node_awakening_page -.->|"starts"| node_awakening_game
node_awakening_game -->|"coordinates"| node_awakening_controls
node_awakening_game -->|"coordinates"| node_awakening_physics
node_awakening_game -->|"coordinates"| node_awakening_ui
node_awakening_game -->|"coordinates"| node_awakening_manager
node_awakening_manager -->|"manages levels"| node_awakening_levels
node_awakening_game -->|"saves progress"| node_progress_store
node_player -->|"opens game"| node_shadow_page
node_shadow_page -.->|"starts"| node_shadow_manager
node_shadow_manager -->|"instantiates level"| node_shadow_levels
node_shadow_levels -->|"extends runtime"| node_shadow_base
node_shadow_levels -->|"creates player"| node_shadow_player
node_shadow_levels -->|"creates dialogue"| node_shadow_ghost
node_shadow_ghost -->|"extends"| node_shadow_pnj
node_shadow_levels -->|"creates enemy"| node_shadow_guardian
node_shadow_levels -->|"creates hazards"| node_shadow_obstacles
node_shadow_levels -->|"applies effects"| node_shadow_zone
node_shadow_base -->|"creates player"| node_shadow_player
node_shadow_base -->|"checks exit"| node_shadow_exit
node_player -->|"opens game"| node_dream_page
node_dream_page -.->|"starts"| node_dream_menu
node_dream_menu -->|"selects level"| node_dream_levels
node_dream_levels -.->|"defines level"| node_dream_base
node_dream_levels -.->|"uses pathfinding"| node_dream_player
node_dream_base -.->|"hosts world"| node_dream_elements

click node_portal_ui "https://github.com/ye4hl0w/gamesonweb/blob/main/index.html"
click node_portal_router "https://github.com/ye4hl0w/gamesonweb/blob/main/index.js"
click node_home "https://github.com/ye4hl0w/gamesonweb/blob/main/sections/home/home.js"
click node_login "https://github.com/ye4hl0w/gamesonweb/blob/main/sections/connexion/connexion.js"
click node_progress_view "https://github.com/ye4hl0w/gamesonweb/blob/main/sections/progress/progress.js"
click node_progress_store "https://github.com/ye4hl0w/gamesonweb/blob/main/gameProgress.js"
click node_awakening_page "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/index.html"
click node_awakening_game "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/game.js"
click node_awakening_controls "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/controls.js"
click node_awakening_physics "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/physics.js"
click node_awakening_ui "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/ui.js"
click node_awakening_levels "https://github.com/ye4hl0w/gamesonweb/tree/main/TheAwakening/js/levels"
click node_awakening_manager "https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/levelManager.js"
click node_shadow_page "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/index.html"
click node_shadow_manager "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/levelManager.js"
click node_shadow_levels "https://github.com/ye4hl0w/gamesonweb/tree/main/ShadowTravelers/js/levels"
click node_shadow_base "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/levels/BaseLevel.js"
click node_shadow_player "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Player.js"
click node_shadow_ghost "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Ghost.js"
click node_shadow_pnj "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/PNJ.js"
click node_shadow_guardian "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Guardian.js"
click node_shadow_obstacles "https://github.com/ye4hl0w/gamesonweb/tree/main/ShadowTravelers/js/elements"
click node_shadow_exit "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/elements/Exit.js"
click node_shadow_zone "https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/elements/ShadowZone.js"
click node_dream_page "https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/index.html"
click node_dream_menu "https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/index.js"
click node_dream_levels "https://github.com/ye4hl0w/gamesonweb/tree/main/DreamTravelers/js/levels"
click node_dream_base "https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/levels/BaseLevel.js"
click node_dream_player "https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/entities/Player.js"
click node_dream_elements "https://github.com/ye4hl0w/gamesonweb/tree/main/DreamTravelers/js/elements"

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_portal_ui,node_portal_router,node_home,node_login,node_progress_view,node_progress_store toneBlue
class node_awakening_page,node_awakening_game,node_awakening_controls,node_awakening_physics,node_awakening_ui,node_awakening_levels,node_awakening_manager,node_browser_storage toneAmber
class node_shadow_page,node_shadow_manager,node_shadow_levels,node_shadow_base,node_shadow_player,node_shadow_ghost,node_shadow_pnj,node_shadow_guardian,node_shadow_obstacles,node_shadow_exit,node_shadow_zone toneMint
class node_dream_page,node_dream_menu,node_dream_levels,node_dream_base,node_dream_player,node_dream_elements toneRose
class node_player toneIndigo
```

## Components

### Portal

- [Portal interface](https://github.com/ye4hl0w/gamesonweb/blob/main/index.html): `index.html`
- [Section loader](https://github.com/ye4hl0w/gamesonweb/blob/main/index.js): `index.js`
- [Home section](https://github.com/ye4hl0w/gamesonweb/blob/main/sections/home/home.js): `sections/home/home.js`
- [Sign-in](https://github.com/ye4hl0w/gamesonweb/blob/main/sections/connexion/connexion.js): `sections/connexion/connexion.js`
- [Progress view](https://github.com/ye4hl0w/gamesonweb/blob/main/sections/progress/progress.js): `sections/progress/progress.js`
- [Progress storage](https://github.com/ye4hl0w/gamesonweb/blob/main/gameProgress.js): `gameProgress.js`

### The Awakening

- [Awakening entry](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/index.html): `TheAwakening/index.html`
- [DOM game loop](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/game.js): `TheAwakening/js/game.js`
- [Controls](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/controls.js): `TheAwakening/js/controls.js`
- [Physics](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/physics.js): `TheAwakening/js/physics.js`
- [Game UI](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/ui.js): `TheAwakening/js/ui.js`
- [Tutorial and levels](https://github.com/ye4hl0w/gamesonweb/tree/main/TheAwakening/js/levels): `TheAwakening/js/levels`
- [Level manager](https://github.com/ye4hl0w/gamesonweb/blob/main/TheAwakening/js/levelManager.js): `TheAwakening/js/levelManager.js`

### Shadow Travelers

- [Shadow entry](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/index.html): `ShadowTravelers/index.html`
- [Canvas level manager](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/levelManager.js): `ShadowTravelers/js/levelManager.js`
- [Shadow levels](https://github.com/ye4hl0w/gamesonweb/tree/main/ShadowTravelers/js/levels): `ShadowTravelers/js/levels`
- [Shared level runtime](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/levels/BaseLevel.js): `ShadowTravelers/js/levels/BaseLevel.js`
- [Player character](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Player.js): `ShadowTravelers/js/entities/Player.js`
- [Ghost dialogue](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Ghost.js): `ShadowTravelers/js/entities/Ghost.js`
- [Character base](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/PNJ.js): `ShadowTravelers/js/entities/PNJ.js`
- [Guardian enemy](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/entities/Guardian.js): `ShadowTravelers/js/entities/Guardian.js`
- [Obstacles and hazards](https://github.com/ye4hl0w/gamesonweb/tree/main/ShadowTravelers/js/elements): `ShadowTravelers/js/elements`
- [Exit portal](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/elements/Exit.js): `ShadowTravelers/js/elements/Exit.js`
- [Shadow zones](https://github.com/ye4hl0w/gamesonweb/blob/main/ShadowTravelers/js/elements/ShadowZone.js): `ShadowTravelers/js/elements/ShadowZone.js`

### Dream Travelers

- [Dream entry](https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/index.html): `DreamTravelers/index.html`
- [Level selection](https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/index.js): `DreamTravelers/js/index.js`
- [3D level layouts](https://github.com/ye4hl0w/gamesonweb/tree/main/DreamTravelers/js/levels): `DreamTravelers/js/levels`
- [3D level runtime](https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/levels/BaseLevel.js): `DreamTravelers/js/levels/BaseLevel.js`
- [Pathfinding player](https://github.com/ye4hl0w/gamesonweb/blob/main/DreamTravelers/js/entities/Player.js): `DreamTravelers/js/entities/Player.js`
- [World elements](https://github.com/ye4hl0w/gamesonweb/tree/main/DreamTravelers/js/elements): `DreamTravelers/js/elements`

### Other components

- **Player**
- **Browser localStorage**

## Connections

- Player → Portal interface: opens (evidence: `README.md`)
- Portal interface → Section loader: starts (evidence: `README.md`)
- Section loader → Home section: loads sections (evidence: `README.md`)
- Section loader → Sign-in: loads sections (evidence: `README.md`)
- Section loader → Progress view: loads sections (evidence: `README.md`)
- Player → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Browser localStorage: stores session (evidence: `README.md`)
- Progress view → Progress storage: displays progress (evidence: `README.md`)
- Progress storage → Browser localStorage: reads and writes (evidence: `README.md`)
- Player → Awakening entry: opens game (evidence: `README.md`)
- Awakening entry → DOM game loop: starts
- DOM game loop → Controls: coordinates (evidence: `README.md`)
- DOM game loop → Physics: coordinates (evidence: `README.md`)
- DOM game loop → Game UI: coordinates (evidence: `README.md`)
- DOM game loop → Level manager: coordinates (evidence: `README.md`)
- Level manager → Tutorial and levels: manages levels (evidence: `README.md`)
- DOM game loop → Progress storage: saves progress (evidence: `README.md`)
- Player → Shadow entry: opens game (evidence: `README.md`)
- Shadow entry → Canvas level manager: starts
- Canvas level manager → Shadow levels: instantiates level (evidence: `ShadowTravelers/js/levelManager.js`)
- Shadow levels → Shared level runtime: extends runtime (evidence: `ShadowTravelers/js/levels/level1.js`)
- Shadow levels → Player character: creates player (evidence: `ShadowTravelers/js/levels/level3.js`)
- Shadow levels → Ghost dialogue: creates dialogue (evidence: `ShadowTravelers/js/levels/level3.js`)
- Ghost dialogue → Character base: extends (evidence: `ShadowTravelers/js/entities/Ghost.js`)
- Shadow levels → Guardian enemy: creates enemy (evidence: `ShadowTravelers/js/levels/level3.js`)
- Shadow levels → Obstacles and hazards: creates hazards (evidence: `ShadowTravelers/js/levels/level3.js`)
- Shadow levels → Shadow zones: applies effects (evidence: `ShadowTravelers/js/levels/level3.js`)
- Shared level runtime → Player character: creates player (evidence: `ShadowTravelers/js/levels/BaseLevel.js`)
- Shared level runtime → Exit portal: checks exit (evidence: `ShadowTravelers/js/levels/BaseLevel.js`)
- Player → Dream entry: opens game (evidence: `README.md`)
- Dream entry → Level selection: starts
- Level selection → 3D level layouts: selects level (evidence: `README.md`)
- 3D level layouts → 3D level runtime: defines level
- 3D level layouts → Pathfinding player: uses pathfinding
- 3D level runtime → World elements: hosts world
