# hikkywannafly/steam-workshop-download architecture

> Architecture diagram of the GitHub repository hikkywannafly/steam-workshop-download, 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/hikkywannafly/steam-workshop-download
- Repository: https://github.com/hikkywannafly/steam-workshop-download

## Overview

Steam Workshop Downloader is a Tauri desktop app for downloading Workshop items without owning the game. The main flow is: enter item URLs or IDs, select a game and destination, then start and monitor a download. The UI bridges to Rust commands for Steam lookups, settings, and downloads; the backend delegates downloads to DepotDownloaderMod and persists settings/history as JSON. The map also includes network diagnostics and app information. Some frontend and downloader internals were not excerpted, so uncertain connections are omitted.

Main entry points: [`src/components/pages/DownloaderPage.tsx`](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/DownloaderPage.tsx) (Downloader page), [`src/App.tsx`](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/App.tsx) (App shell), [`src-tauri/src/commands/system.rs`](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/commands/system.rs) (System commands), [`src/lib/tauri.ts`](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/lib/tauri.ts) (Tauri API wrappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_download_page["Downloader page<br/>[DownloaderPage.tsx]"]
  node_game_selector["Game selector<br/>[GameSelector.tsx]"]
  node_account_selector["Account selector"]
  node_path_selector["Path selector<br/>[PathSelector.tsx]"]
  node_workshop_preview["Workshop preview"]
  node_console["Download console<br/>[ConsoleOutput.tsx]"]
  node_settings_page["Settings page<br/>[SettingsPage.tsx]"]
  node_network_page["Network diagnostics<br/>[NetworkPage.tsx]"]
  node_about_page["About page<br/>[AboutPage.tsx]"]
  node_toast["Toast notifications<br/>[ToastContainer.tsx]"]
end

subgraph group_bridge["Tauri command bridge"]
  node_bridge_api["Tauri API wrappers<br/>[tauri.ts]"]
  node_notifications["Toast utility<br/>[notifications.ts]"]
end

subgraph group_backend["Rust backend"]
  node_system_commands["System commands<br/>[system.rs]"]
  node_download_commands["Download command<br/>[download.rs]"]
  node_downloader["Downloader service<br/>[downloader.rs]"]
  node_storage[("Settings and history<br/>[storage.rs]")]
  node_settings_model["Settings model<br/>[settings.rs]"]
end

subgraph group_integrations["External services"]
  node_steam_store{{"Steam Store API"}}
  node_steam_workshop{{"Steam Workshop API"}}
  node_depot_downloader["DepotDownloaderMod"]
  node_workshop_site{{"Steam Workshop site"}}
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"shows"| node_download_page
node_app -->|"shows"| node_network_page
node_app -->|"shows"| node_settings_page
node_app -->|"shows"| node_about_page
node_app -->|"renders"| node_toast
node_download_page -->|"renders"| node_game_selector
node_download_page -->|"renders"| node_account_selector
node_download_page -->|"renders"| node_path_selector
node_download_page -->|"renders"| node_workshop_preview
node_download_page -->|"renders"| node_console
node_download_page -->|"invokes"| node_bridge_api
node_download_page -->|"notifies"| node_notifications
node_workshop_preview -->|"fetches details"| node_bridge_api
node_workshop_preview -->|"opens item"| node_workshop_site
node_network_page -->|"tests Steam"| node_bridge_api
node_toast -->|"receives toasts"| node_notifications
node_bridge_api -->|"invokes"| node_system_commands
node_bridge_api -->|"invokes"| node_download_commands
node_system_commands -->|"loads and saves"| node_storage
node_storage -->|"persists"| node_settings_model
node_download_commands -->|"delegates"| node_downloader
node_system_commands -->|"checks runtime"| node_downloader
node_system_commands -->|"searches games"| node_steam_store
node_system_commands -->|"fetches details"| node_steam_workshop
node_downloader -->|"runs downloads"| node_depot_downloader

click node_app "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/App.tsx"
click node_download_page "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/DownloaderPage.tsx"
click node_game_selector "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/GameSelector.tsx"
click node_account_selector "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/AccountSelector.tsx"
click node_path_selector "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/PathSelector.tsx"
click node_workshop_preview "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/WorkshopPreview.tsx"
click node_console "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/ConsoleOutput.tsx"
click node_settings_page "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/SettingsPage.tsx"
click node_network_page "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/NetworkPage.tsx"
click node_about_page "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/AboutPage.tsx"
click node_toast "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/ToastContainer.tsx"
click node_bridge_api "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/lib/tauri.ts"
click node_notifications "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/lib/notifications.ts"
click node_system_commands "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/commands/system.rs"
click node_download_commands "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/commands/download.rs"
click node_downloader "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/services/downloader.rs"
click node_storage "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/services/storage.rs"
click node_settings_model "https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/models/settings.rs"

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_download_page,node_game_selector,node_account_selector,node_path_selector,node_workshop_preview,node_console,node_settings_page,node_network_page,node_about_page,node_toast,node_user toneBlue
class node_bridge_api,node_notifications toneAmber
class node_system_commands,node_download_commands,node_downloader,node_storage,node_settings_model toneMint
class node_steam_store,node_steam_workshop,node_depot_downloader,node_workshop_site toneRose
```

## Components

### Desktop interface

- [App shell](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/App.tsx): `src/App.tsx`
- [Downloader page](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/DownloaderPage.tsx): `src/components/pages/DownloaderPage.tsx`
- [Game selector](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/GameSelector.tsx): `src/components/ui/GameSelector.tsx`
- [Account selector](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/AccountSelector.tsx): `src/components/ui/AccountSelector.tsx`
- [Path selector](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/PathSelector.tsx): `src/components/ui/PathSelector.tsx`
- [Workshop preview](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/WorkshopPreview.tsx): `src/components/ui/WorkshopPreview.tsx`
- [Download console](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/ConsoleOutput.tsx): `src/components/ui/ConsoleOutput.tsx`
- [Settings page](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/SettingsPage.tsx): `src/components/pages/SettingsPage.tsx`
- [Network diagnostics](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/NetworkPage.tsx): `src/components/pages/NetworkPage.tsx`
- [About page](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/pages/AboutPage.tsx): `src/components/pages/AboutPage.tsx`
- [Toast notifications](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/components/ui/ToastContainer.tsx): `src/components/ui/ToastContainer.tsx`

### Tauri command bridge

- [Tauri API wrappers](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/lib/tauri.ts): `src/lib/tauri.ts`
- [Toast utility](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src/lib/notifications.ts): `src/lib/notifications.ts`

### Rust backend

- [System commands](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/commands/system.rs): `src-tauri/src/commands/system.rs`
- [Download command](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/commands/download.rs): `src-tauri/src/commands/download.rs`
- [Downloader service](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/services/downloader.rs): `src-tauri/src/services/downloader.rs`
- [Settings and history](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/services/storage.rs): `src-tauri/src/services/storage.rs`
- [Settings model](https://github.com/hikkywannafly/steam-workshop-download/blob/main/src-tauri/src/models/settings.rs): `src-tauri/src/models/settings.rs`

### External services

- **Steam Store API**
- **Steam Workshop API**
- **DepotDownloaderMod**
- **Steam Workshop site**

### Other components

- **User**

## Connections

- User → App shell: uses (evidence: `README.md`)
- App shell → Downloader page: shows (evidence: `src/App.tsx`)
- App shell → Network diagnostics: shows (evidence: `src/App.tsx`)
- App shell → Settings page: shows (evidence: `src/App.tsx`)
- App shell → About page: shows (evidence: `src/App.tsx`)
- App shell → Toast notifications: renders (evidence: `src/App.tsx`)
- Downloader page → Game selector: renders (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Account selector: renders (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Path selector: renders (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Workshop preview: renders (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Download console: renders (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Tauri API wrappers: invokes (evidence: `src/components/pages/DownloaderPage.tsx`)
- Downloader page → Toast utility: notifies (evidence: `src/components/pages/DownloaderPage.tsx`)
- Workshop preview → Tauri API wrappers: fetches details (evidence: `src/components/ui/WorkshopPreview.tsx`)
- Workshop preview → Steam Workshop site: opens item (evidence: `src/components/ui/WorkshopPreview.tsx`)
- Network diagnostics → Tauri API wrappers: tests Steam (evidence: `src/components/pages/NetworkPage.tsx`)
- Toast notifications → Toast utility: receives toasts (evidence: `src/components/ui/ToastContainer.tsx`)
- Tauri API wrappers → System commands: invokes (evidence: `src/lib/tauri.ts`)
- Tauri API wrappers → Download command: invokes (evidence: `src/lib/tauri.ts`)
- System commands → Settings and history: loads and saves (evidence: `src-tauri/src/commands/system.rs`)
- Settings and history → Settings model: persists (evidence: `src-tauri/src/services/storage.rs`)
- Download command → Downloader service: delegates (evidence: `src-tauri/src/commands/download.rs`)
- System commands → Downloader service: checks runtime (evidence: `src-tauri/src/commands/system.rs`)
- System commands → Steam Store API: searches games (evidence: `src-tauri/src/commands/system.rs`)
- System commands → Steam Workshop API: fetches details (evidence: `src-tauri/src/commands/system.rs`)
- Downloader service → DepotDownloaderMod: runs downloads (evidence: `README.md`)
