# markterence/discord-quest-completer architecture

> Architecture diagram of the GitHub repository markterence/discord-quest-completer, 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/markterence/discord-quest-completer
- Repository: https://github.com/markterence/discord-quest-completer

## Overview

Discord Quest Completer is a desktop app for selecting Discord-detectable games, creating small dummy executables, and launching them so Discord can recognize game activity without installing full games. The main flow runs from the game catalog and selection UI through Tauri commands to filesystem setup and process control; the app also includes Discord Rich Presence support and a Playground view. The README documents the Windows runner and quest-completion use case. Some command wiring and runner details are only partially excerpted, so uncertain links are omitted.

Main entry points: [`src/pages/HomeView.vue`](https://github.com/markterence/discord-quest-completer/blob/main/src/pages/HomeView.vue) (Game manager), [`src-tauri/src/lib.rs`](https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/lib.rs) (Tauri command host), [`src/App.vue`](https://github.com/markterence/discord-quest-completer/blob/main/src/App.vue) (Vue app shell), [`src/components/MainLayout.vue`](https://github.com/markterence/discord-quest-completer/blob/main/src/components/MainLayout.vue) (Main layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["App interface"]
  node_app["Vue app shell<br/>[App.vue]"]
  node_layout["Main layout<br/>[MainLayout.vue]"]
  node_home["Game manager<br/>[HomeView.vue]"]
  node_executables["Executable picker"]
  node_playground["Activity playground<br/>[Playground.vue]"]
  node_appstate["Shared app state<br/>[app-state.ts]"]
  node_notifications["Timed notifications"]
  node_gamecard["Game card<br/>[GameCard.vue]"]
  node_verified_icon["Verified badge<br/>[IconVerified.vue]"]
  node_rust_icon["Rust icon<br/>[IconRustLang.vue]"]
  node_vue_icon["Vue icon<br/>[IconVueJs.vue]"]
end

subgraph group_catalog["Game catalog"]
  node_catalog_fetch["Catalog fetch and fallback<br/>[fetch-gamelist.ts]"]
  node_catalog_data["Bundled game catalog<br/>[gamelist.json]"]
  node_discord_catalog["Discord game catalog API"]
  node_catalog_mirror["Catalog mirror"]
  node_random_id["Game entry IDs<br/>[random-string.ts]"]
end

subgraph group_native["Native runtime"]
  node_tauri["Tauri command host<br/>[lib.rs]"]
  node_runner["Dummy game creation and process control<br/>[runner.rs]"]
  node_game_files[("Generated game files<br/>[lib.rs]")]
  node_windows_runner["Windows dummy runner<br/>[main.cpp]"]
end

subgraph group_discord["Discord activity"]
  node_rpc["Discord RPC client<br/>[rpc.rs]"]
  node_discord_client["Discord desktop client"]
end

node_user(("Desktop user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_layout
node_app -->|"renders"| node_home
node_app -->|"renders"| node_playground
node_app -->|"reads page state"| node_appstate
node_layout -->|"changes page"| node_appstate
node_layout -->|"renders"| node_rust_icon
node_layout -->|"renders"| node_vue_icon
node_home -->|"loads catalog"| node_catalog_fetch
node_home -->|"adds logs"| node_appstate
node_home -->|"renders and handles actions"| node_executables
node_home -->|"renders status"| node_notifications
node_home -->|"renders"| node_verified_icon
node_home -->|"assigns entry IDs"| node_random_id
node_home -->|"invokes game commands"| node_tauri
node_executables -->|"emits play actions"| node_home
node_playground -->|"uses shared state"| node_appstate
node_catalog_fetch -->|"requests remote catalogs"| node_tauri
node_catalog_fetch -->|"loads fallback"| node_catalog_data
node_tauri -->|"fetches catalog"| node_catalog_mirror
node_tauri -->|"fetches catalog"| node_discord_catalog
node_tauri -->|"dispatches commands"| node_runner
node_runner -->|"creates executables"| node_game_files
node_windows_runner -.->|"enables game detection"| node_discord_client
node_runner -.->|"copies runner template"| node_windows_runner
node_tauri -->|"manages RPC activity"| node_rpc
node_rpc -.->|"connects activity"| node_discord_client
node_gamecard -.->|"supports game display"| node_home

click node_app "https://github.com/markterence/discord-quest-completer/blob/main/src/App.vue"
click node_layout "https://github.com/markterence/discord-quest-completer/blob/main/src/components/MainLayout.vue"
click node_home "https://github.com/markterence/discord-quest-completer/blob/main/src/pages/HomeView.vue"
click node_executables "https://github.com/markterence/discord-quest-completer/blob/main/src/components/GameExecutables.vue"
click node_playground "https://github.com/markterence/discord-quest-completer/blob/main/src/pages/Playground.vue"
click node_appstate "https://github.com/markterence/discord-quest-completer/blob/main/src/composables/app-state.ts"
click node_notifications "https://github.com/markterence/discord-quest-completer/blob/main/src/components/TimedNotification.vue"
click node_gamecard "https://github.com/markterence/discord-quest-completer/blob/main/src/components/GameCard.vue"
click node_catalog_fetch "https://github.com/markterence/discord-quest-completer/blob/main/src/composables/fetch-gamelist.ts"
click node_catalog_data "https://github.com/markterence/discord-quest-completer/blob/main/src/assets/gamelist.json"
click node_tauri "https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/lib.rs"
click node_runner "https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/runner.rs"
click node_game_files "https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/lib.rs"
click node_windows_runner "https://github.com/markterence/discord-quest-completer/blob/main/src-win/src/main.cpp"
click node_rpc "https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/rpc.rs"
click node_random_id "https://github.com/markterence/discord-quest-completer/blob/main/src/utils/random-string.ts"
click node_verified_icon "https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconVerified.vue"
click node_rust_icon "https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconRustLang.vue"
click node_vue_icon "https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconVueJs.vue"

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_layout,node_home,node_executables,node_playground,node_appstate,node_notifications,node_gamecard,node_verified_icon,node_rust_icon,node_vue_icon,node_user toneBlue
class node_catalog_fetch,node_catalog_data,node_discord_catalog,node_catalog_mirror,node_random_id toneAmber
class node_tauri,node_runner,node_game_files,node_windows_runner toneMint
class node_rpc,node_discord_client toneRose
```

## Components

### App interface

- [Vue app shell](https://github.com/markterence/discord-quest-completer/blob/main/src/App.vue): `src/App.vue`
- [Main layout](https://github.com/markterence/discord-quest-completer/blob/main/src/components/MainLayout.vue): `src/components/MainLayout.vue`
- [Game manager](https://github.com/markterence/discord-quest-completer/blob/main/src/pages/HomeView.vue): `src/pages/HomeView.vue`
- [Executable picker](https://github.com/markterence/discord-quest-completer/blob/main/src/components/GameExecutables.vue): `src/components/GameExecutables.vue`
- [Activity playground](https://github.com/markterence/discord-quest-completer/blob/main/src/pages/Playground.vue): `src/pages/Playground.vue`
- [Shared app state](https://github.com/markterence/discord-quest-completer/blob/main/src/composables/app-state.ts): `src/composables/app-state.ts`
- [Timed notifications](https://github.com/markterence/discord-quest-completer/blob/main/src/components/TimedNotification.vue): `src/components/TimedNotification.vue`
- [Game card](https://github.com/markterence/discord-quest-completer/blob/main/src/components/GameCard.vue): `src/components/GameCard.vue`
- [Verified badge](https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconVerified.vue): `src/components/IconVerified.vue`
- [Rust icon](https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconRustLang.vue): `src/components/IconRustLang.vue`
- [Vue icon](https://github.com/markterence/discord-quest-completer/blob/main/src/components/IconVueJs.vue): `src/components/IconVueJs.vue`

### Game catalog

- [Catalog fetch and fallback](https://github.com/markterence/discord-quest-completer/blob/main/src/composables/fetch-gamelist.ts): `src/composables/fetch-gamelist.ts`
- [Bundled game catalog](https://github.com/markterence/discord-quest-completer/blob/main/src/assets/gamelist.json): `src/assets/gamelist.json`
- **Discord game catalog API**
- **Catalog mirror**
- [Game entry IDs](https://github.com/markterence/discord-quest-completer/blob/main/src/utils/random-string.ts): `src/utils/random-string.ts`

### Native runtime

- [Tauri command host](https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Dummy game creation and process control](https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/runner.rs): `src-tauri/src/runner.rs`
- [Generated game files](https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Windows dummy runner](https://github.com/markterence/discord-quest-completer/blob/main/src-win/src/main.cpp): `src-win/src/main.cpp`

### Discord activity

- [Discord RPC client](https://github.com/markterence/discord-quest-completer/blob/main/src-tauri/src/rpc.rs): `src-tauri/src/rpc.rs`
- **Discord desktop client**

### Other components

- **Desktop user**

## Connections

- Desktop user → Vue app shell: uses (evidence: `README.md`)
- Vue app shell → Main layout: renders (evidence: `src/App.vue`)
- Vue app shell → Game manager: renders (evidence: `src/App.vue`)
- Vue app shell → Activity playground: renders (evidence: `src/App.vue`)
- Vue app shell → Shared app state: reads page state (evidence: `src/App.vue`)
- Main layout → Shared app state: changes page (evidence: `src/components/MainLayout.vue`)
- Main layout → Rust icon: renders (evidence: `src/components/MainLayout.vue`)
- Main layout → Vue icon: renders (evidence: `src/components/MainLayout.vue`)
- Game manager → Catalog fetch and fallback: loads catalog (evidence: `src/pages/HomeView.vue`)
- Game manager → Shared app state: adds logs (evidence: `src/pages/HomeView.vue`)
- Game manager → Executable picker: renders and handles actions (evidence: `src/pages/HomeView.vue`)
- Game manager → Timed notifications: renders status (evidence: `src/pages/HomeView.vue`)
- Game manager → Verified badge: renders (evidence: `src/pages/HomeView.vue`)
- Game manager → Game entry IDs: assigns entry IDs (evidence: `src/pages/HomeView.vue`)
- Game manager → Tauri command host: invokes game commands (evidence: `src/pages/HomeView.vue`)
- Executable picker → Game manager: emits play actions (evidence: `src/pages/HomeView.vue`)
- Activity playground → Shared app state: uses shared state (evidence: `src/pages/Playground.vue`)
- Catalog fetch and fallback → Tauri command host: requests remote catalogs (evidence: `src/composables/fetch-gamelist.ts`)
- Catalog fetch and fallback → Bundled game catalog: loads fallback (evidence: `src/composables/fetch-gamelist.ts`)
- Tauri command host → Catalog mirror: fetches catalog (evidence: `src-tauri/src/lib.rs`)
- Tauri command host → Discord game catalog API: fetches catalog (evidence: `src-tauri/src/lib.rs`)
- Tauri command host → Dummy game creation and process control: dispatches commands (evidence: `src-tauri/src/lib.rs`)
- Dummy game creation and process control → Generated game files: creates executables (evidence: `src-tauri/src/lib.rs`)
- Windows dummy runner → Discord desktop client: enables game detection (evidence: `README.md`)
- Dummy game creation and process control → Windows dummy runner: copies runner template
- Tauri command host → Discord RPC client: manages RPC activity (evidence: `src-tauri/src/lib.rs`)
- Discord RPC client → Discord desktop client: connects activity
- Game card → Game manager: supports game display
