# minulog-spcdmn/poe2-trivia architecture

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

- Interactive diagram: https://gitdiagram.com/minulog-spcdmn/poe2-trivia
- Repository: https://github.com/minulog-spcdmn/poe2-trivia

## Overview

PoE2.Quest is a browser-based multiplayer Path of Exile 2 item-trivia game. Players choose a room or play alone, answer art-based questions, and build locally stored progress; online rooms connect browsers directly, with Workers supporting matchmaking and relay access. Major branches include Delve, device sync, settings, and visitor analytics, alongside the game’s visual and audio layers. Edges use README statements and SOURCE INDEX references; unsampled subsystems are included only where documented, so some internal connections are intentionally omitted.

Main entry points: [`src/lib/session.svelte.ts`](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/session.svelte.ts) (Game session), [`src/main.ts`](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/main.ts) (App entry), [`src/Root.svelte`](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/Root.svelte) (Game shell), [`src/lib/peer.ts`](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/peer.ts) (Peer connections)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Game experience"]
  node_entry["App entry<br/>[main.ts]"]
  node_shell["Game shell<br/>[Root.svelte]"]
end

subgraph group_play["Play systems"]
  node_session["Game session<br/>[session.svelte.ts]"]
  node_question["Trivia questions"]
  node_game_rules["Game rules<br/>[game.ts]"]
  node_delve["Delve runs<br/>[delve.ts]"]
  node_daily["Daily trivia<br/>[daily.ts]"]
end

subgraph group_online["Online services"]
  node_peer["Peer connections<br/>[peer.ts]"]
  node_rooms["Room discovery<br/>[rooms.ts]"]
  node_matchmaking["Matchmaking worker<br/>[worker.js]"]
  node_relay["Relay worker<br/>[worker.js]"]
end

subgraph group_progress["Progress and privacy"]
  node_storage[("Browser storage<br/>[storage.ts]")]
  node_codex["Codex and records<br/>[codex.ts]"]
  node_sync["Device sync"]
  node_analytics["Visitor analytics<br/>[count.ts]"]
end

subgraph group_presentation["Rendering and sound"]
  node_descent["Delve environments<br/>[descent.ts]"]
  node_backdrop["Scene backdrop<br/>[backdrop.ts]"]
  node_effects["Visual effects<br/>[core.ts]"]
  node_sound["Sound system<br/>[sound.ts]"]
end

node_player(("Player"))

node_player -->|"opens game"| node_entry
node_entry -->|"mounts"| node_shell
node_shell -.->|"runs session"| node_session
node_session -.->|"presents questions"| node_question
node_session -->|"uses rules"| node_game_rules
node_session -->|"connects players"| node_peer
node_session -.->|"lists rooms"| node_rooms
node_peer -->|"finds peers"| node_matchmaking
node_peer -->|"requests relay login"| node_relay
node_session -->|"records runs"| node_delve
node_delve -->|"sets depth"| node_descent
node_session -.->|"persists progress"| node_storage
node_codex -->|"keeps records"| node_storage
node_sync -->|"shares progress"| node_storage
node_player -->|"plays daily"| node_daily
node_entry -->|"counts visits"| node_analytics
node_shell -->|"shows backdrop"| node_backdrop
node_shell -->|"shows effects"| node_effects
node_entry -->|"installs sound"| node_sound

click node_entry "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/main.ts"
click node_shell "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/Root.svelte"
click node_session "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/session.svelte.ts"
click node_question "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/components/QuestionView.svelte"
click node_game_rules "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/game.ts"
click node_delve "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/delve.ts"
click node_descent "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/descent.ts"
click node_peer "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/peer.ts"
click node_rooms "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/rooms.ts"
click node_matchmaking "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/signal/worker.js"
click node_relay "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/relay/worker.js"
click node_storage "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/storage.ts"
click node_codex "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/codex.ts"
click node_sync "https://github.com/minulog-spcdmn/poe2-trivia/tree/main/src/lib/sync"
click node_daily "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/daily.ts"
click node_analytics "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/count.ts"
click node_backdrop "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/backdrop.ts"
click node_effects "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/fx/core.ts"
click node_sound "https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/sound.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_entry,node_shell toneBlue
class node_session,node_question,node_game_rules,node_delve,node_daily toneAmber
class node_peer,node_rooms,node_matchmaking,node_relay toneMint
class node_storage,node_codex,node_sync,node_analytics toneRose
class node_descent,node_backdrop,node_effects,node_sound,node_player toneIndigo
```

## Components

### Game experience

- [App entry](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/main.ts): `src/main.ts`
- [Game shell](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/Root.svelte): `src/Root.svelte`

### Play systems

- [Game session](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/session.svelte.ts): `src/lib/session.svelte.ts`
- [Trivia questions](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/components/QuestionView.svelte): `src/components/QuestionView.svelte`
- [Game rules](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/game.ts): `src/lib/game.ts`
- [Delve runs](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/delve.ts): `src/lib/delve.ts`
- [Daily trivia](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/daily.ts): `src/lib/daily.ts`

### Online services

- [Peer connections](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/peer.ts): `src/lib/peer.ts`
- [Room discovery](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/rooms.ts): `src/lib/rooms.ts`
- [Matchmaking worker](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/signal/worker.js): `signal/worker.js`
- [Relay worker](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/relay/worker.js): `relay/worker.js`

### Progress and privacy

- [Browser storage](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Codex and records](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/codex.ts): `src/lib/codex.ts`
- [Device sync](https://github.com/minulog-spcdmn/poe2-trivia/tree/main/src/lib/sync): `src/lib/sync`
- [Visitor analytics](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/count.ts): `src/lib/count.ts`

### Rendering and sound

- [Delve environments](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/descent.ts): `src/lib/descent.ts`
- [Scene backdrop](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/backdrop.ts): `src/lib/backdrop.ts`
- [Visual effects](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/fx/core.ts): `src/lib/fx/core.ts`
- [Sound system](https://github.com/minulog-spcdmn/poe2-trivia/blob/main/src/lib/sound.ts): `src/lib/sound.ts`

### Other components

- **Player**

## Connections

- Player → App entry: opens game (evidence: `README.md`)
- App entry → Game shell: mounts (evidence: `src/main.ts`)
- Game shell → Game session: runs session
- Game session → Trivia questions: presents questions (evidence: `src/components/QuestionView.svelte`)
- Game session → Game rules: uses rules (evidence: `src/lib/session.svelte.ts`)
- Game session → Peer connections: connects players (evidence: `README.md`)
- Game session → Room discovery: lists rooms (evidence: `src/lib/session.svelte.ts`)
- Peer connections → Matchmaking worker: finds peers (evidence: `README.md`)
- Peer connections → Relay worker: requests relay login (evidence: `README.md`)
- Game session → Delve runs: records runs (evidence: `src/lib/session.svelte.ts`)
- Delve runs → Delve environments: sets depth (evidence: `src/lib/descent.ts`)
- Game session → Browser storage: persists progress (evidence: `src/lib/session.svelte.ts`)
- Codex and records → Browser storage: keeps records (evidence: `README.md`)
- Device sync → Browser storage: shares progress (evidence: `README.md`)
- Player → Daily trivia: plays daily (evidence: `README.md`)
- App entry → Visitor analytics: counts visits (evidence: `src/lib/count.ts`)
- Game shell → Scene backdrop: shows backdrop
- Game shell → Visual effects: shows effects
- App entry → Sound system: installs sound (evidence: `src/main.ts`)
