# the-silent-soul-88/tss-arcade-hub architecture

> Architecture diagram of the GitHub repository the-silent-soul-88/tss-arcade-hub, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/the-silent-soul-88/tss-arcade-hub
- Repository: https://github.com/the-silent-soul-88/tss-arcade-hub

## Overview

TSS GAMESPACE is a static browser arcade: visitors browse a registered game library, search or filter it, choose a game (or a random visible result), play it in an iframe, and return to the lobby. The main runtime layer in app.js owns the registry, filtering, card interactions, and player state. The README documents additional loading/error handling, keyboard controls, and responsive behavior; unsampled HTML and CSS are represented by their paths, but their internal wiring is not inferred.

Main entry points: [`app.js`](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/app.js) (Launcher Runtime), [`index.html`](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/index.html) (Lobby UI), [`style.css`](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/style.css) (Responsive Styling), [`games/Battle_Royale_3D_mobile.html`](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Battle_Royale_3D_mobile.html) (Battle Royale 3D)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Arcade Interface"]
  node_lobby["Lobby UI<br/>[index.html]"]
  node_styles["Responsive Styling<br/>[style.css]"]
end

subgraph group_launcher["Library and Player"]
  node_runtime["Launcher Runtime<br/>[app.js]"]
end

subgraph group_games["Registered Games"]
  node_battle["Battle Royale 3D"]
  node_chess["Chess<br/>[chess_mobile.html]"]
  node_cyber["Cyber Runner 3D"]
  node_dungeon["Dungeon Hopper"]
  node_katana["Katana Type"]
  node_memory["Memory Match<br/>[memory.html]"]
  node_drift["Neon Drift"]
  node_puzzle["Number Puzzle<br/>[puzzle.html]"]
  node_runner["Neon Runner<br/>[runner.html]"]
  node_snake["Snake<br/>[snake.html]"]
  node_sudoku["Sudoku<br/>[sudoku_mobile.html]"]
end

node_visitor(("Player"))

node_visitor -->|"browses"| node_lobby
node_lobby -->|"provides controls"| node_runtime
node_runtime -->|"renders library"| node_lobby
node_runtime -->|"loads iframe"| node_battle
node_runtime -->|"loads iframe"| node_chess
node_runtime -->|"loads iframe"| node_cyber
node_runtime -->|"loads iframe"| node_dungeon
node_runtime -->|"loads iframe"| node_katana
node_runtime -->|"loads iframe"| node_memory
node_runtime -->|"loads iframe"| node_drift
node_runtime -->|"loads iframe"| node_puzzle
node_runtime -->|"loads iframe"| node_runner
node_runtime -->|"loads iframe"| node_snake
node_runtime -->|"loads iframe"| node_sudoku
node_lobby -->|"styled by"| node_styles

click node_lobby "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/index.html"
click node_styles "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/style.css"
click node_runtime "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/app.js"
click node_battle "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Battle_Royale_3D_mobile.html"
click node_chess "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/chess_mobile.html"
click node_cyber "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/cyber_runner_3d_mobile.html"
click node_dungeon "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Dungeon_Hopper_mobile.html"
click node_katana "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Katana_Type_mobile.html"
click node_memory "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/memory.html"
click node_drift "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Neon_Drift_mobile.html"
click node_puzzle "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/puzzle.html"
click node_runner "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/runner.html"
click node_snake "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/snake.html"
click node_sudoku "https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/sudoku_mobile.html"

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_lobby,node_styles toneBlue
class node_runtime toneAmber
class node_battle,node_chess,node_cyber,node_dungeon,node_katana,node_memory,node_drift,node_puzzle,node_runner,node_snake,node_sudoku toneMint
class node_visitor toneIndigo
```

## Components

### Arcade Interface

- [Lobby UI](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/index.html): `index.html`
- [Responsive Styling](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/style.css): `style.css`

### Library and Player

- [Launcher Runtime](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/app.js): `app.js`

### Registered Games

- [Battle Royale 3D](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Battle_Royale_3D_mobile.html): `games/Battle_Royale_3D_mobile.html`
- [Chess](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/chess_mobile.html): `games/chess_mobile.html`
- [Cyber Runner 3D](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/cyber_runner_3d_mobile.html): `games/cyber_runner_3d_mobile.html`
- [Dungeon Hopper](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Dungeon_Hopper_mobile.html): `games/Dungeon_Hopper_mobile.html`
- [Katana Type](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Katana_Type_mobile.html): `games/Katana_Type_mobile.html`
- [Memory Match](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/memory.html): `games/memory.html`
- [Neon Drift](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/Neon_Drift_mobile.html): `games/Neon_Drift_mobile.html`
- [Number Puzzle](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/puzzle.html): `games/puzzle.html`
- [Neon Runner](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/runner.html): `games/runner.html`
- [Snake](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/snake.html): `games/snake.html`
- [Sudoku](https://github.com/the-silent-soul-88/tss-arcade-hub/blob/main/games/sudoku_mobile.html): `games/sudoku_mobile.html`

### Other components

- **Player**

## Connections

- Player → Lobby UI: browses (evidence: `README.md`)
- Lobby UI → Launcher Runtime: provides controls (evidence: `README.md`)
- Launcher Runtime → Lobby UI: renders library (evidence: `README.md`)
- Launcher Runtime → Battle Royale 3D: loads iframe (evidence: `app.js`)
- Launcher Runtime → Chess: loads iframe (evidence: `app.js`)
- Launcher Runtime → Cyber Runner 3D: loads iframe (evidence: `app.js`)
- Launcher Runtime → Dungeon Hopper: loads iframe (evidence: `app.js`)
- Launcher Runtime → Katana Type: loads iframe (evidence: `app.js`)
- Launcher Runtime → Memory Match: loads iframe (evidence: `app.js`)
- Launcher Runtime → Neon Drift: loads iframe (evidence: `app.js`)
- Launcher Runtime → Number Puzzle: loads iframe (evidence: `app.js`)
- Launcher Runtime → Neon Runner: loads iframe (evidence: `app.js`)
- Launcher Runtime → Snake: loads iframe (evidence: `app.js`)
- Launcher Runtime → Sudoku: loads iframe (evidence: `app.js`)
- Lobby UI → Responsive Styling: styled by (evidence: `README.md`)
