# ccbluex/liquidlauncher architecture

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

- Interactive diagram: https://gitdiagram.com/ccbluex/liquidlauncher
- Repository: https://github.com/ccbluex/liquidlauncher

## Overview

LiquidLauncher is a Tauri desktop launcher for LiquidBounce Minecraft. Users authenticate, inspect builds and add-ons, configure settings, and launch the client; the UI issues commands to Rust, which coordinates API access, game installation, and process lifecycle. The graph also preserves news/logging, Modrinth, account, and marketplace capabilities documented or evidenced in the source index. Edges are limited to explicit README statements or shown/indexed references; several unsampled feature links are omitted rather than inferred.

Main entry points: [`src-tauri/src/app/gui/commands/client.rs`](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/gui/commands/client.rs) (Tauri commands), [`src/lib/main/settings/ClientSettings.svelte`](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/ClientSettings.svelte) (Client settings), [`src-tauri/src/app/marketplace/view.rs`](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/view.rs) (Marketplace operations), [`src/lib/main/MainScreen.svelte`](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/MainScreen.svelte) (Home and launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Launcher interface"]
  node_window["Window routing<br/>[Window.svelte]"]
  node_home["Home and launch<br/>[MainScreen.svelte]"]
  node_login["Login screen<br/>[LoginScreen.svelte]"]
  node_clientsettings["Client settings"]
  node_buildview["Build selection<br/>[Builds.svelte]"]
  node_modrinthview["Modrinth mods<br/>[Modrinth.svelte]"]
  node_browse["Marketplace browse<br/>[Browse.svelte]"]
  node_detail["Marketplace detail<br/>[Detail.svelte]"]
  node_clientlog["Client log<br/>[ClientLog.svelte]"]
end

subgraph group_app["Application services"]
  node_commands["Tauri commands<br/>[client.rs]"]
  node_authcommands["Auth commands<br/>[auth.rs]"]
  node_builds["Build service<br/>[builds.rs]"]
  node_clientapi["LiquidBounce API<br/>[client_api.rs]"]
  node_options["Launcher options<br/>[options.rs]"]
  node_news["News service<br/>[client_api.rs]"]
  node_modrinth["Modrinth service<br/>[modrinth.rs]"]
end

subgraph group_market["Marketplace"]
  node_marketapi["Marketplace API<br/>[api.rs]"]
  node_marketview["Marketplace operations<br/>[view.rs]"]
  node_marketinstall["Add-on installation<br/>[install.rs]"]
  node_revisions["Revision management<br/>[revisions.rs]"]
  node_staging["Marketplace staging<br/>[staging.rs]"]
  node_subscriptions["Subscriptions<br/>[subscriptions.rs]"]
end

subgraph group_game["Minecraft runtime"]
  node_version["Version metadata<br/>[version.rs]"]
  node_launcher["Game launcher<br/>[mod.rs]"]
  node_prelauncher["Launch preparation<br/>[prelauncher.rs]"]
  node_java["Java runtime<br/>[jre_downloader.rs]"]
end

subgraph group_foundation["Identity and utilities"]
  node_identity["Client account auth<br/>[shared.rs]"]
  node_minecraftauth["Minecraft auth<br/>[auth.rs]"]
  node_utilities["Download and files<br/>[download.rs]"]
  node_logservice["Log upload service"]
end

node_user(("Launcher user"))

node_user -->|"opens"| node_window
node_window -->|"routes to"| node_home
node_window -->|"routes to"| node_login
node_home -->|"invokes"| node_commands
node_clientsettings -->|"invokes"| node_commands
node_home -->|"renders"| node_clientsettings
node_clientsettings -->|"renders"| node_buildview
node_clientsettings -->|"renders"| node_modrinthview
node_clientsettings -->|"renders"| node_browse
node_clientsettings -->|"renders"| node_detail
node_home -->|"renders"| node_clientlog
node_clientlog -->|"uploads log"| node_logservice
node_commands -->|"fetches build"| node_builds
node_builds -->|"requests API"| node_clientapi
node_commands -->|"requests data"| node_clientapi
node_commands -->|"reads options"| node_options
node_authcommands -->|"renews account"| node_identity
node_commands -->|"renews account"| node_identity
node_commands -->|"manages mods"| node_modrinth
node_commands -->|"dispatches marketplace"| node_marketview
node_marketview -->|"requests listings"| node_marketapi
node_marketview -->|"installs items"| node_marketinstall
node_marketview -->|"manages revisions"| node_revisions
node_marketview -->|"reads subscriptions"| node_subscriptions
node_marketview -->|"stages changes"| node_staging
node_commands -->|"prepares launch"| node_prelauncher
node_commands -->|"starts client"| node_launcher
node_commands -->|"loads manifest"| node_version
node_version -->|"uses launch data"| node_launcher
node_version -->|"downloads metadata"| node_utilities
node_launcher -.->|"obtains runtime"| node_java
node_marketinstall -->|"downloads files"| node_utilities
node_clientapi -->|"authenticates requests"| node_identity
node_identity -->|"provides token"| node_clientapi

click node_window "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/Window.svelte"
click node_home "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/MainScreen.svelte"
click node_login "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/login/LoginScreen.svelte"
click node_clientsettings "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/ClientSettings.svelte"
click node_buildview "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/Builds.svelte"
click node_modrinthview "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/mods/Modrinth.svelte"
click node_browse "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/marketplace/Browse.svelte"
click node_detail "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/marketplace/Detail.svelte"
click node_clientlog "https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/log/ClientLog.svelte"
click node_commands "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/gui/commands/client.rs"
click node_authcommands "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/gui/commands/auth.rs"
click node_builds "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/builds.rs"
click node_clientapi "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/client_api.rs"
click node_options "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/options.rs"
click node_news "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/client_api.rs"
click node_marketapi "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/api.rs"
click node_marketview "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/view.rs"
click node_marketinstall "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/install.rs"
click node_revisions "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/revisions.rs"
click node_staging "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/staging.rs"
click node_subscriptions "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/subscriptions.rs"
click node_modrinth "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/modrinth.rs"
click node_identity "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/auth/shared.rs"
click node_minecraftauth "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/auth.rs"
click node_version "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/version.rs"
click node_launcher "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/launcher/mod.rs"
click node_prelauncher "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/prelauncher.rs"
click node_java "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/java/jre_downloader.rs"
click node_utilities "https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/utils/download.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_window,node_home,node_login,node_clientsettings,node_buildview,node_modrinthview,node_browse,node_detail,node_clientlog,node_user toneBlue
class node_commands,node_authcommands,node_builds,node_clientapi,node_options,node_news,node_modrinth toneAmber
class node_marketapi,node_marketview,node_marketinstall,node_revisions,node_staging,node_subscriptions toneMint
class node_version,node_launcher,node_prelauncher,node_java toneRose
class node_identity,node_minecraftauth,node_utilities,node_logservice toneIndigo
```

## Components

### Launcher interface

- [Window routing](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/Window.svelte): `src/lib/Window.svelte`
- [Home and launch](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/MainScreen.svelte): `src/lib/main/MainScreen.svelte`
- [Login screen](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/login/LoginScreen.svelte): `src/lib/login/LoginScreen.svelte`
- [Client settings](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/ClientSettings.svelte): `src/lib/main/settings/ClientSettings.svelte`
- [Build selection](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/Builds.svelte): `src/lib/main/settings/client/Builds.svelte`
- [Modrinth mods](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/mods/Modrinth.svelte): `src/lib/main/settings/client/mods/Modrinth.svelte`
- [Marketplace browse](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/marketplace/Browse.svelte): `src/lib/main/settings/client/marketplace/Browse.svelte`
- [Marketplace detail](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/settings/client/marketplace/Detail.svelte): `src/lib/main/settings/client/marketplace/Detail.svelte`
- [Client log](https://github.com/ccbluex/liquidlauncher/blob/main/src/lib/main/log/ClientLog.svelte): `src/lib/main/log/ClientLog.svelte`

### Application services

- [Tauri commands](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/gui/commands/client.rs): `src-tauri/src/app/gui/commands/client.rs`
- [Auth commands](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/gui/commands/auth.rs): `src-tauri/src/app/gui/commands/auth.rs`
- [Build service](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/builds.rs): `src-tauri/src/app/builds.rs`
- [LiquidBounce API](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/client_api.rs): `src-tauri/src/app/client_api.rs`
- [Launcher options](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/options.rs): `src-tauri/src/app/options.rs`
- [News service](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/client_api.rs): `src-tauri/src/app/client_api.rs`
- [Modrinth service](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/modrinth.rs): `src-tauri/src/app/modrinth.rs`

### Marketplace

- [Marketplace API](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/api.rs): `src-tauri/src/app/marketplace/api.rs`
- [Marketplace operations](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/view.rs): `src-tauri/src/app/marketplace/view.rs`
- [Add-on installation](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/install.rs): `src-tauri/src/app/marketplace/install.rs`
- [Revision management](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/revisions.rs): `src-tauri/src/app/marketplace/revisions.rs`
- [Marketplace staging](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/staging.rs): `src-tauri/src/app/marketplace/staging.rs`
- [Subscriptions](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/app/marketplace/subscriptions.rs): `src-tauri/src/app/marketplace/subscriptions.rs`

### Minecraft runtime

- [Version metadata](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/version.rs): `src-tauri/src/minecraft/version.rs`
- [Game launcher](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/launcher/mod.rs): `src-tauri/src/minecraft/launcher/mod.rs`
- [Launch preparation](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/prelauncher.rs): `src-tauri/src/minecraft/prelauncher.rs`
- [Java runtime](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/java/jre_downloader.rs): `src-tauri/src/minecraft/java/jre_downloader.rs`

### Identity and utilities

- [Client account auth](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/auth/shared.rs): `src-tauri/src/auth/shared.rs`
- [Minecraft auth](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/minecraft/auth.rs): `src-tauri/src/minecraft/auth.rs`
- [Download and files](https://github.com/ccbluex/liquidlauncher/blob/main/src-tauri/src/utils/download.rs): `src-tauri/src/utils/download.rs`
- **Log upload service**

### Other components

- **Launcher user**

## Connections

- Launcher user → Window routing: opens (evidence: `README.md`)
- Window routing → Home and launch: routes to (evidence: `src/lib/Window.svelte`)
- Window routing → Login screen: routes to (evidence: `src/lib/Window.svelte`)
- Home and launch → Tauri commands: invokes (evidence: `src/lib/main/MainScreen.svelte`)
- Client settings → Tauri commands: invokes (evidence: `src/lib/main/settings/ClientSettings.svelte`)
- Home and launch → Client settings: renders (evidence: `src/lib/main/MainScreen.svelte`)
- Client settings → Build selection: renders (evidence: `src/lib/main/settings/ClientSettings.svelte`)
- Client settings → Modrinth mods: renders (evidence: `src/lib/main/settings/ClientSettings.svelte`)
- Client settings → Marketplace browse: renders (evidence: `src/lib/main/settings/ClientSettings.svelte`)
- Client settings → Marketplace detail: renders (evidence: `src/lib/main/settings/ClientSettings.svelte`)
- Home and launch → Client log: renders (evidence: `src/lib/main/MainScreen.svelte`)
- Client log → Log upload service: uploads log (evidence: `src/lib/main/log/ClientLog.svelte`)
- Tauri commands → Build service: fetches build (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Build service → LiquidBounce API: requests API (evidence: `src-tauri/src/app/builds.rs`)
- Tauri commands → LiquidBounce API: requests data (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Tauri commands → Launcher options: reads options (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Auth commands → Client account auth: renews account (evidence: `src-tauri/src/app/gui/commands/auth.rs`)
- Tauri commands → Client account auth: renews account (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Tauri commands → Modrinth service: manages mods (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Tauri commands → Marketplace operations: dispatches marketplace (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Marketplace operations → Marketplace API: requests listings (evidence: `src-tauri/src/app/marketplace/view.rs`)
- Marketplace operations → Add-on installation: installs items (evidence: `src-tauri/src/app/marketplace/view.rs`)
- Marketplace operations → Revision management: manages revisions (evidence: `src-tauri/src/app/marketplace/view.rs`)
- Marketplace operations → Subscriptions: reads subscriptions (evidence: `src-tauri/src/app/marketplace/view.rs`)
- Marketplace operations → Marketplace staging: stages changes (evidence: `src-tauri/src/app/marketplace/mod.rs`)
- Tauri commands → Launch preparation: prepares launch (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Tauri commands → Game launcher: starts client (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Tauri commands → Version metadata: loads manifest (evidence: `src-tauri/src/app/gui/commands/client.rs`)
- Version metadata → Game launcher: uses launch data (evidence: `src-tauri/src/minecraft/version.rs`)
- Version metadata → Download and files: downloads metadata (evidence: `src-tauri/src/minecraft/version.rs`)
- Game launcher → Java runtime: obtains runtime
- Add-on installation → Download and files: downloads files (evidence: `src-tauri/src/app/marketplace/install.rs`)
- LiquidBounce API → Client account auth: authenticates requests (evidence: `src-tauri/src/app/client_api.rs`)
- Client account auth → LiquidBounce API: provides token (evidence: `src-tauri/src/auth/shared.rs`)
