# dotnetdork/game-dev architecture

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

- Interactive diagram: https://gitdiagram.com/dotnetdork/game-dev
- Repository: https://github.com/dotnetdork/game-dev

## Overview

The League Game Development Course is a browser-based Phaser game studio: students follow lessons, edit a shared game, ask AI for help, and play the result. The documented client keeps student code and progress in browser storage; the server gates access and relays AI requests without storing or running student code. The graph includes the major AI, course, design-board, asset, and game-running capabilities described in the README. Some frontend wiring is documented rather than shown in excerpts, so those edges cite the README.

Main entry points: [`app/routes/ai.js`](https://github.com/dotnetdork/game-dev/blob/main/app/routes/ai.js) (AI Route), [`app/server.js`](https://github.com/dotnetdork/game-dev/blob/main/app/server.js) (Express Server), [`app/public/js/game-runner.js`](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/game-runner.js) (Game Runner), [`app/ai/provider.js`](https://github.com/dotnetdork/game-dev/blob/main/app/ai/provider.js) (Model Provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Student Studio"]
  node_course_ui["Course Outline<br/>[course.js]"]
  node_lesson_view["Lesson View<br/>[pages.js]"]
  node_editor["Code Editor<br/>[editor.js]"]
  node_ai_panel["AI Assistant<br/>[ai.js]"]
  node_design_board["Design Board<br/>[board.js]"]
  node_game_runner["Game Runner<br/>[game-runner.js]"]
  node_browser_store[("Project Storage<br/>[storage.js]")]
  node_assets[("Asset Catalog<br/>[assets-manifest.js]")]
  node_sandbox["Game Sandbox<br/>[game-runner.js]"]
end

subgraph group_ai["AI Services"]
  node_ai_route["AI Route<br/>[ai.js]"]
  node_model_config["Model Selection<br/>[models.js]"]
  node_prompt_loader["Prompt Loader<br/>[loader.js]"]
  node_provider["Model Provider<br/>[provider.js]"]
  node_ai_tools["Lookup Tools<br/>[tools.js]"]
  node_mcp["MCP Server<br/>[mcp-server.js]"]
  node_guards["Response Guards<br/>[guards.js]"]
  node_grade_check["Grade Checker<br/>[grade-check.js]"]
  node_quiz_check["Quiz Checker<br/>[quiz-check.js]"]
  node_usage["Usage Meter<br/>[usage.js]"]
end

subgraph group_server["Server Services"]
  node_server["Express Server<br/>[server.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_student_store[("Hosted State Store<br/>[store.js]")]
  node_telemetry[("Telemetry<br/>[telemetry.js]")]
end

subgraph group_content["Course Resources"]
  node_course_content["Course Content"]
end

node_student(("Student"))
node_game_deps["Phaser Runtime"]

node_student -->|"chooses lesson"| node_course_ui
node_course_ui -->|"opens lesson"| node_lesson_view
node_lesson_view -->|"shows content"| node_course_content
node_student -->|"edits game"| node_editor
node_student -->|"asks assistant"| node_ai_panel
node_student -->|"plans game"| node_design_board
node_editor -->|"saves project"| node_browser_store
node_browser_store -->|"supplies scripts"| node_game_runner
node_game_runner -->|"assembles iframe"| node_sandbox
node_sandbox -->|"runs game"| node_game_deps
node_ai_panel -->|"posts request"| node_ai_route
node_ai_route -->|"returns ops"| node_editor
node_game_runner -->|"injects assets"| node_assets
node_server -->|"requires auth"| node_auth
node_server -->|"mounts route"| node_ai_route
node_server -->|"uses state store"| node_student_store
node_server -->|"records events"| node_telemetry
node_ai_route -->|"resolves model"| node_model_config
node_ai_route -->|"builds prompt"| node_prompt_loader
node_ai_route -->|"calls model"| node_provider
node_ai_route -->|"checks response"| node_guards
node_ai_route -->|"checks grading"| node_grade_check
node_ai_route -->|"checks quiz"| node_quiz_check
node_ai_route -->|"records request"| node_telemetry
node_provider -->|"runs lookups"| node_ai_tools
node_provider -->|"records usage"| node_usage
node_model_config -->|"reads agent model"| node_prompt_loader
node_mcp -->|"wraps tools"| node_ai_tools
node_usage -->|"writes usage events"| node_telemetry

click node_course_ui "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/course.js"
click node_lesson_view "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/pages.js"
click node_editor "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/editor.js"
click node_ai_panel "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/ai.js"
click node_design_board "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/board.js"
click node_game_runner "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/game-runner.js"
click node_browser_store "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/storage.js"
click node_assets "https://github.com/dotnetdork/game-dev/blob/main/app/public/assets-manifest.js"
click node_sandbox "https://github.com/dotnetdork/game-dev/blob/main/app/public/js/game-runner.js"
click node_server "https://github.com/dotnetdork/game-dev/blob/main/app/server.js"
click node_auth "https://github.com/dotnetdork/game-dev/blob/main/app/auth.js"
click node_student_store "https://github.com/dotnetdork/game-dev/blob/main/app/store.js"
click node_telemetry "https://github.com/dotnetdork/game-dev/blob/main/app/telemetry.js"
click node_ai_route "https://github.com/dotnetdork/game-dev/blob/main/app/routes/ai.js"
click node_model_config "https://github.com/dotnetdork/game-dev/blob/main/app/ai/models.js"
click node_prompt_loader "https://github.com/dotnetdork/game-dev/blob/main/app/ai/loader.js"
click node_provider "https://github.com/dotnetdork/game-dev/blob/main/app/ai/provider.js"
click node_ai_tools "https://github.com/dotnetdork/game-dev/blob/main/app/ai/tools.js"
click node_mcp "https://github.com/dotnetdork/game-dev/blob/main/app/ai/mcp-server.js"
click node_guards "https://github.com/dotnetdork/game-dev/blob/main/app/ai/guards.js"
click node_grade_check "https://github.com/dotnetdork/game-dev/blob/main/app/ai/grade-check.js"
click node_quiz_check "https://github.com/dotnetdork/game-dev/blob/main/app/ai/quiz-check.js"
click node_usage "https://github.com/dotnetdork/game-dev/blob/main/app/ai/usage.js"
click node_course_content "https://github.com/dotnetdork/game-dev/tree/main/app/content"

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_course_ui,node_lesson_view,node_editor,node_ai_panel,node_design_board,node_game_runner,node_browser_store,node_assets,node_sandbox toneBlue
class node_ai_route,node_model_config,node_prompt_loader,node_provider,node_ai_tools,node_mcp,node_guards,node_grade_check,node_quiz_check,node_usage toneAmber
class node_server,node_auth,node_student_store,node_telemetry toneMint
class node_course_content toneRose
class node_student,node_game_deps toneIndigo
```

## Components

### Student Studio

- [Course Outline](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/course.js): `app/public/js/course.js`
- [Lesson View](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/pages.js): `app/public/js/pages.js`
- [Code Editor](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/editor.js): `app/public/js/editor.js`
- [AI Assistant](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/ai.js): `app/public/js/ai.js`
- [Design Board](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/board.js): `app/public/js/board.js`
- [Game Runner](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/game-runner.js): `app/public/js/game-runner.js`
- [Project Storage](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/storage.js): `app/public/js/storage.js`
- [Asset Catalog](https://github.com/dotnetdork/game-dev/blob/main/app/public/assets-manifest.js): `app/public/assets-manifest.js`
- [Game Sandbox](https://github.com/dotnetdork/game-dev/blob/main/app/public/js/game-runner.js): `app/public/js/game-runner.js`

### AI Services

- [AI Route](https://github.com/dotnetdork/game-dev/blob/main/app/routes/ai.js): `app/routes/ai.js`
- [Model Selection](https://github.com/dotnetdork/game-dev/blob/main/app/ai/models.js): `app/ai/models.js`
- [Prompt Loader](https://github.com/dotnetdork/game-dev/blob/main/app/ai/loader.js): `app/ai/loader.js`
- [Model Provider](https://github.com/dotnetdork/game-dev/blob/main/app/ai/provider.js): `app/ai/provider.js`
- [Lookup Tools](https://github.com/dotnetdork/game-dev/blob/main/app/ai/tools.js): `app/ai/tools.js`
- [MCP Server](https://github.com/dotnetdork/game-dev/blob/main/app/ai/mcp-server.js): `app/ai/mcp-server.js`
- [Response Guards](https://github.com/dotnetdork/game-dev/blob/main/app/ai/guards.js): `app/ai/guards.js`
- [Grade Checker](https://github.com/dotnetdork/game-dev/blob/main/app/ai/grade-check.js): `app/ai/grade-check.js`
- [Quiz Checker](https://github.com/dotnetdork/game-dev/blob/main/app/ai/quiz-check.js): `app/ai/quiz-check.js`
- [Usage Meter](https://github.com/dotnetdork/game-dev/blob/main/app/ai/usage.js): `app/ai/usage.js`

### Server Services

- [Express Server](https://github.com/dotnetdork/game-dev/blob/main/app/server.js): `app/server.js`
- [Authentication](https://github.com/dotnetdork/game-dev/blob/main/app/auth.js): `app/auth.js`
- [Hosted State Store](https://github.com/dotnetdork/game-dev/blob/main/app/store.js): `app/store.js`
- [Telemetry](https://github.com/dotnetdork/game-dev/blob/main/app/telemetry.js): `app/telemetry.js`

### Course Resources

- [Course Content](https://github.com/dotnetdork/game-dev/tree/main/app/content): `app/content`

### Other components

- **Student**
- **Phaser Runtime**

## Connections

- Student → Course Outline: chooses lesson (evidence: `README.md`)
- Course Outline → Lesson View: opens lesson (evidence: `README.md`)
- Lesson View → Course Content: shows content (evidence: `README.md`)
- Student → Code Editor: edits game (evidence: `README.md`)
- Student → AI Assistant: asks assistant (evidence: `README.md`)
- Student → Design Board: plans game (evidence: `README.md`)
- Code Editor → Project Storage: saves project (evidence: `README.md`)
- Project Storage → Game Runner: supplies scripts (evidence: `README.md`)
- Game Runner → Game Sandbox: assembles iframe (evidence: `README.md`)
- Game Sandbox → Phaser Runtime: runs game (evidence: `README.md`)
- AI Assistant → AI Route: posts request (evidence: `README.md`)
- AI Route → Code Editor: returns ops (evidence: `README.md`)
- Game Runner → Asset Catalog: injects assets (evidence: `README.md`)
- Express Server → Authentication: requires auth (evidence: `app/server.js`)
- Express Server → AI Route: mounts route (evidence: `app/server.js`)
- Express Server → Hosted State Store: uses state store (evidence: `app/server.js`)
- Express Server → Telemetry: records events (evidence: `app/server.js`)
- AI Route → Model Selection: resolves model (evidence: `app/routes/ai.js`)
- AI Route → Prompt Loader: builds prompt (evidence: `app/routes/ai.js`)
- AI Route → Model Provider: calls model (evidence: `app/routes/ai.js`)
- AI Route → Response Guards: checks response (evidence: `app/routes/ai.js`)
- AI Route → Grade Checker: checks grading (evidence: `app/routes/ai.js`)
- AI Route → Quiz Checker: checks quiz (evidence: `app/routes/ai.js`)
- AI Route → Telemetry: records request (evidence: `app/routes/ai.js`)
- Model Provider → Lookup Tools: runs lookups (evidence: `app/ai/provider.js`)
- Model Provider → Usage Meter: records usage (evidence: `app/ai/provider.js`)
- Model Selection → Prompt Loader: reads agent model (evidence: `app/ai/models.js`)
- MCP Server → Lookup Tools: wraps tools (evidence: `app/ai/mcp-server.js`)
- Usage Meter → Telemetry: writes usage events (evidence: `app/ai/usage.js`)
