# catlab-design/realitylauncher-client architecture

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

- Interactive diagram: https://gitdiagram.com/catlab-design/realitylauncher-client
- Repository: https://github.com/catlab-design/realitylauncher-client

## Overview

Reality Launcher is a desktop Minecraft launcher: users authenticate, create or join instances, manage or explore content, then launch and monitor the game. React presents the workflows and calls Rust commands through Tauri IPC; Rust handles local configuration, instance files, downloads, game execution, and service integrations. The README also documents cloud sync, wardrobe, updates, Discord presence, and administration. Some of these backend capabilities are represented from the README and command registration rather than sampled implementation; their internal call relationships are therefore omitted.

Main entry points: [`src-tauri/src/main.rs`](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/main.rs) (Tauri command router), [`src/api.ts`](https://github.com/catlab-design/realitylauncher-client/blob/main/src/api.ts) (Command proxy), [`src-tauri/src/instances.rs`](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/instances.rs) (Instance storage), [`src-tauri/src/cloud.rs`](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/cloud.rs) (Cloud sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Launcher UI"]
  node_ui["React workflows<br/>[LauncherApp.tsx]"]
  node_explore_ui["Explore projects"]
  node_instance_ui["Instance management<br/>[ModPack.tsx]"]
  node_server_ui["Community servers<br/>[ServerMenu.tsx]"]
  node_wardrobe_ui["Wardrobe<br/>[Wardrobe.tsx]"]
  node_live_logs["Live game logs<br/>[LiveLog.tsx]"]
  node_translations["Translations<br/>[translations.ts]"]
  node_config_store["Config state<br/>[configStore.ts]"]
end

subgraph group_bridge["IPC Bridge"]
  node_bridge_api["Command proxy<br/>[api.ts]"]
  node_tauri["Tauri command router<br/>[main.rs]"]
end

subgraph group_instances["Instances &amp; Content"]
  node_instance_data[("Instance storage<br/>[instances.rs]")]
  node_modpack["Modpack import<br/>[modpack.rs]"]
  node_content["Instance content<br/>[content.rs]"]
  node_explorer_backend["Project catalogues<br/>[modrinth.rs]"]
  node_curseforge["CurseForge catalogue<br/>[curseforge.rs]"]
  node_mod_meta["Mod metadata<br/>[mod_meta.rs]"]
  node_cloud["Cloud sync<br/>[cloud.rs]"]
end

subgraph group_runtime["Runtime Services"]
  node_auth["Authentication<br/>[auth.rs]"]
  node_config[("Config persistence<br/>[config.rs]")]
  node_download["Verified downloads<br/>[download.rs]"]
  node_op_guard["Operation guard<br/>[op_guard.rs]"]
  node_java["Java detection<br/>[java.rs]"]
  node_launcher["Game launch<br/>[launcher.rs]"]
  node_http_client["Pooled HTTP<br/>[http_client.rs]"]
end

subgraph group_integrations["External Services"]
  node_admin["Administration<br/>[admin.rs]"]
  node_wardrobe["Skin services<br/>[wardrobe.rs]"]
  node_updater["Auto-updater<br/>[update.rs]"]
  node_discord["Discord presence<br/>[discord.rs]"]
  node_reality_api{{"Reality backend API"}}
end

node_user(("Launcher user"))
node_game_process(("Minecraft process"))

node_user -->|"uses"| node_ui
node_ui -.->|"reads settings"| node_config_store
node_ui -->|"localizes"| node_translations
node_ui -->|"invokes commands"| node_bridge_api
node_explore_ui -.->|"requests projects"| node_bridge_api
node_instance_ui -.->|"manages instances"| node_bridge_api
node_server_ui -.->|"manages servers"| node_bridge_api
node_wardrobe_ui -.->|"manages skins"| node_bridge_api
node_live_logs -.->|"receives game output"| node_bridge_api
node_bridge_api -->|"invokes IPC"| node_tauri
node_tauri -->|"dispatches commands"| node_auth
node_tauri -->|"dispatches commands"| node_config
node_tauri -->|"dispatches commands"| node_instance_data
node_tauri -->|"dispatches commands"| node_content
node_tauri -->|"dispatches commands"| node_modpack
node_tauri -->|"dispatches commands"| node_cloud
node_tauri -->|"dispatches commands"| node_java
node_tauri -->|"dispatches commands"| node_launcher
node_tauri -->|"dispatches commands"| node_admin
node_tauri -->|"dispatches commands"| node_wardrobe
node_config -->|"provides game path"| node_instance_data
node_config -->|"uses guard"| node_op_guard
node_instance_data -->|"uses guard"| node_op_guard
node_content -->|"resolves directories"| node_instance_data
node_content -->|"uses metadata"| node_mod_meta
node_modpack -->|"uses instance data"| node_instance_data
node_modpack -->|"downloads files"| node_download
node_cloud -->|"imports instances"| node_instance_data
node_cloud -->|"syncs files"| node_download
node_cloud -->|"uses guard"| node_op_guard
node_explorer_backend -->|"uses metadata"| node_mod_meta
node_curseforge -->|"uses metadata"| node_mod_meta
node_launcher -->|"loads instance"| node_instance_data
node_launcher -->|"uses Java"| node_java
node_launcher -->|"uses guard"| node_op_guard
node_launcher -->|"starts game"| node_game_process
node_auth -->|"stores session"| node_config
node_auth -->|"sends requests"| node_http_client
node_cloud -->|"uses tokens"| node_auth
node_cloud -->|"syncs with"| node_reality_api
node_admin -->|"checks identity"| node_auth
node_admin -->|"sends requests"| node_http_client
node_download -->|"fetches files"| node_http_client
node_java -->|"downloads runtime"| node_http_client
node_launcher -->|"fetches assets"| node_http_client
node_updater -.->|"checks releases"| node_reality_api
node_discord -.->|"reports activity"| node_game_process

click node_ui "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/LauncherApp.tsx"
click node_explore_ui "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ExploreTabs/ProjectDetailPage.tsx"
click node_instance_ui "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ModPack.tsx"
click node_server_ui "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ServerMenu.tsx"
click node_wardrobe_ui "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/Wardrobe.tsx"
click node_live_logs "https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/LiveLog.tsx"
click node_translations "https://github.com/catlab-design/realitylauncher-client/blob/main/src/i18n/translations.ts"
click node_config_store "https://github.com/catlab-design/realitylauncher-client/blob/main/src/store/configStore.ts"
click node_bridge_api "https://github.com/catlab-design/realitylauncher-client/blob/main/src/api.ts"
click node_tauri "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/main.rs"
click node_auth "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/auth.rs"
click node_config "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/config.rs"
click node_instance_data "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/instances.rs"
click node_modpack "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/modpack.rs"
click node_content "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/content.rs"
click node_explorer_backend "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/modrinth.rs"
click node_curseforge "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/curseforge.rs"
click node_mod_meta "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/mod_meta.rs"
click node_cloud "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/cloud.rs"
click node_download "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/download.rs"
click node_op_guard "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/op_guard.rs"
click node_java "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/java.rs"
click node_launcher "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/launcher.rs"
click node_http_client "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/http_client.rs"
click node_admin "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/admin.rs"
click node_wardrobe "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/wardrobe.rs"
click node_updater "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/update.rs"
click node_discord "https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/discord.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_ui,node_explore_ui,node_instance_ui,node_server_ui,node_wardrobe_ui,node_live_logs,node_translations,node_config_store,node_user toneBlue
class node_bridge_api,node_tauri toneAmber
class node_instance_data,node_modpack,node_content,node_explorer_backend,node_curseforge,node_mod_meta,node_cloud toneMint
class node_auth,node_config,node_download,node_op_guard,node_java,node_launcher,node_http_client toneRose
class node_admin,node_wardrobe,node_updater,node_discord,node_reality_api,node_game_process toneIndigo
```

## Components

### Launcher UI

- [React workflows](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/LauncherApp.tsx): `src/components/LauncherApp.tsx`
- [Explore projects](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ExploreTabs/ProjectDetailPage.tsx): `src/components/tabs/ExploreTabs/ProjectDetailPage.tsx`
- [Instance management](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ModPack.tsx): `src/components/tabs/ModPack.tsx`
- [Community servers](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/ServerMenu.tsx): `src/components/tabs/ServerMenu.tsx`
- [Wardrobe](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/Wardrobe.tsx): `src/components/tabs/Wardrobe.tsx`
- [Live game logs](https://github.com/catlab-design/realitylauncher-client/blob/main/src/components/tabs/LiveLog.tsx): `src/components/tabs/LiveLog.tsx`
- [Translations](https://github.com/catlab-design/realitylauncher-client/blob/main/src/i18n/translations.ts): `src/i18n/translations.ts`
- [Config state](https://github.com/catlab-design/realitylauncher-client/blob/main/src/store/configStore.ts): `src/store/configStore.ts`

### IPC Bridge

- [Command proxy](https://github.com/catlab-design/realitylauncher-client/blob/main/src/api.ts): `src/api.ts`
- [Tauri command router](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/main.rs): `src-tauri/src/main.rs`

### Instances & Content

- [Instance storage](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/instances.rs): `src-tauri/src/instances.rs`
- [Modpack import](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/modpack.rs): `src-tauri/src/modpack.rs`
- [Instance content](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/content.rs): `src-tauri/src/content.rs`
- [Project catalogues](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/modrinth.rs): `src-tauri/src/modrinth.rs`
- [CurseForge catalogue](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/curseforge.rs): `src-tauri/src/curseforge.rs`
- [Mod metadata](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/mod_meta.rs): `src-tauri/src/mod_meta.rs`
- [Cloud sync](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/cloud.rs): `src-tauri/src/cloud.rs`

### Runtime Services

- [Authentication](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/auth.rs): `src-tauri/src/auth.rs`
- [Config persistence](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/config.rs): `src-tauri/src/config.rs`
- [Verified downloads](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/download.rs): `src-tauri/src/download.rs`
- [Operation guard](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/op_guard.rs): `src-tauri/src/op_guard.rs`
- [Java detection](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/java.rs): `src-tauri/src/java.rs`
- [Game launch](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/launcher.rs): `src-tauri/src/launcher.rs`
- [Pooled HTTP](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/http_client.rs): `src-tauri/src/http_client.rs`

### External Services

- [Administration](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/admin.rs): `src-tauri/src/admin.rs`
- [Skin services](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/wardrobe.rs): `src-tauri/src/wardrobe.rs`
- [Auto-updater](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/update.rs): `src-tauri/src/update.rs`
- [Discord presence](https://github.com/catlab-design/realitylauncher-client/blob/main/src-tauri/src/discord.rs): `src-tauri/src/discord.rs`
- **Reality backend API**

### Other components

- **Launcher user**
- **Minecraft process**

## Connections

- Launcher user → React workflows: uses (evidence: `README.md`)
- React workflows → Config state: reads settings
- React workflows → Translations: localizes
- React workflows → Command proxy: invokes commands (evidence: `README.md`)
- Explore projects → Command proxy: requests projects
- Instance management → Command proxy: manages instances
- Community servers → Command proxy: manages servers
- Wardrobe → Command proxy: manages skins
- Live game logs → Command proxy: receives game output
- Command proxy → Tauri command router: invokes IPC (evidence: `README.md`)
- Tauri command router → Authentication: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Config persistence: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Instance storage: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Instance content: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Modpack import: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Cloud sync: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Java detection: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Game launch: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Administration: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Tauri command router → Skin services: dispatches commands (evidence: `src-tauri/src/main.rs`)
- Config persistence → Instance storage: provides game path (evidence: `src-tauri/src/instances.rs`)
- Config persistence → Operation guard: uses guard (evidence: `src-tauri/src/config.rs`)
- Instance storage → Operation guard: uses guard (evidence: `src-tauri/src/instances.rs`)
- Instance content → Instance storage: resolves directories (evidence: `src-tauri/src/content.rs`)
- Instance content → Mod metadata: uses metadata (evidence: `src-tauri/src/content.rs`)
- Modpack import → Instance storage: uses instance data (evidence: `src-tauri/src/modpack.rs`)
- Modpack import → Verified downloads: downloads files (evidence: `README.md`)
- Cloud sync → Instance storage: imports instances (evidence: `src-tauri/src/cloud.rs`)
- Cloud sync → Verified downloads: syncs files (evidence: `README.md`)
- Cloud sync → Operation guard: uses guard (evidence: `src-tauri/src/cloud.rs`)
- Project catalogues → Mod metadata: uses metadata (evidence: `src-tauri/src/modrinth.rs`)
- CurseForge catalogue → Mod metadata: uses metadata (evidence: `src-tauri/src/curseforge.rs`)
- Game launch → Instance storage: loads instance (evidence: `src-tauri/src/launcher.rs`)
- Game launch → Java detection: uses Java (evidence: `src-tauri/src/launcher.rs`)
- Game launch → Operation guard: uses guard (evidence: `src-tauri/src/launcher.rs`)
- Game launch → Minecraft process: starts game (evidence: `README.md`)
- Authentication → Config persistence: stores session (evidence: `src-tauri/src/auth.rs`)
- Authentication → Pooled HTTP: sends requests (evidence: `src-tauri/src/auth.rs`)
- Cloud sync → Authentication: uses tokens (evidence: `src-tauri/src/cloud.rs`)
- Cloud sync → Reality backend API: syncs with (evidence: `README.md`)
- Administration → Authentication: checks identity (evidence: `src-tauri/src/admin.rs`)
- Administration → Pooled HTTP: sends requests (evidence: `src-tauri/src/admin.rs`)
- Verified downloads → Pooled HTTP: fetches files (evidence: `src-tauri/src/download.rs`)
- Java detection → Pooled HTTP: downloads runtime (evidence: `src-tauri/src/java.rs`)
- Game launch → Pooled HTTP: fetches assets (evidence: `src-tauri/src/launcher.rs`)
- Auto-updater → Reality backend API: checks releases
- Discord presence → Minecraft process: reports activity
