# elripalda/recomplauncher architecture

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

- Interactive diagram: https://gitdiagram.com/elripalda/recomplauncher
- Repository: https://github.com/elripalda/recomplauncher

## Overview

RecompLauncher is a desktop launcher for discovering, installing, setting up, updating, and playing PC recomps using the player’s own game files. Its main workflow runs from catalog discovery through release selection, download and verification, optional Easy Setup, library management, and launch. Supporting branches include saves and cloud sync, per-game display effects, controller-focused Big Picture mode, reports, and developer notifications. The README documents the product flow; source excerpts and the index identify key Rust modules, but several feature implementations were not sampled, so those links are documented rather than code-verified.

Main entry points: [`ui/app.js`](https://github.com/elripalda/recomplauncher/blob/main/ui/app.js) (Launcher UI), [`src-tauri/src/install.rs`](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/install.rs) (Download and verify), [`src-tauri/src/inputs.rs`](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/inputs.rs) (Easy Setup inputs), [`src-tauri/src/library.rs`](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/library.rs) (Installed library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and community"]
  node_catalog[("Catalog and releases<br/>[catalog.rs]")]
  node_player_reports["Player reports<br/>[usage.rs]"]
  node_developer_updates["Developer follows<br/>[devtools.rs]"]
end

subgraph group_setup["Install and setup"]
  node_assets["Build selection<br/>[assets.rs]"]
  node_install["Download and verify<br/>[install.rs]"]
  node_easy_setup["Easy Setup inputs<br/>[inputs.rs]"]
  node_own_setup["Setup orchestration<br/>[own_setup.rs]"]
  node_roms["Game-file handling<br/>[roms.rs]"]
  node_flatpak["Linux packaging support<br/>[flatpak.rs]"]
  node_system_environment["Platform environment<br/>[sysenv.rs]"]
end

subgraph group_library["Library and play"]
  node_boot["Launch profiles<br/>[boot.rs]"]
  node_library_store[("Installed library<br/>[library.rs]")]
  node_games["Multi-game titles<br/>[games.rs]"]
  node_profile["Game configuration<br/>[profile.rs]"]
  node_saves["Save backups<br/>[saves.rs]"]
  node_cloud["Cloud saves<br/>[cloud.rs]"]
end

subgraph group_experience["Player experience"]
  node_launcher_ui["Launcher UI<br/>[app.js]"]
  node_looks["Per-game looks<br/>[looks.rs]"]
  node_big_picture["Big Picture<br/>[tv.js]"]
end

node_player(("Player"))

node_player -->|"uses"| node_launcher_ui
node_launcher_ui -->|"discovers titles"| node_catalog
node_catalog -->|"offers releases"| node_assets
node_assets -->|"selects build"| node_install
node_launcher_ui -->|"requests install"| node_install
node_install -.->|"installs title"| node_library_store
node_launcher_ui -->|"selects game files"| node_easy_setup
node_own_setup -->|"uses installer"| node_install
node_easy_setup -->|"reads setup rules"| node_profile
node_profile -->|"defines launch"| node_boot
node_launcher_ui -->|"manages library"| node_library_store
node_library_store -->|"tracks game entries"| node_games
node_launcher_ui -->|"backs up saves"| node_saves
node_saves -->|"syncs saves"| node_cloud
node_launcher_ui -->|"chooses effects"| node_looks
node_player -->|"uses controller mode"| node_big_picture
node_launcher_ui -->|"views reports"| node_player_reports
node_launcher_ui -->|"follows developers"| node_developer_updates
node_install -.->|"supports Linux"| node_flatpak
node_install -->|"checks platform"| node_system_environment
node_easy_setup -.->|"handles game files"| node_roms

click node_launcher_ui "https://github.com/elripalda/recomplauncher/blob/main/ui/app.js"
click node_catalog "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/catalog.rs"
click node_assets "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/assets.rs"
click node_install "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/install.rs"
click node_easy_setup "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/inputs.rs"
click node_own_setup "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/own_setup.rs"
click node_boot "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/boot.rs"
click node_library_store "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/library.rs"
click node_games "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/games.rs"
click node_profile "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/profile.rs"
click node_roms "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/roms.rs"
click node_saves "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/saves.rs"
click node_cloud "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/cloud.rs"
click node_looks "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/looks.rs"
click node_big_picture "https://github.com/elripalda/recomplauncher/blob/main/ui/tv.js"
click node_player_reports "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/usage.rs"
click node_developer_updates "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/devtools.rs"
click node_flatpak "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/flatpak.rs"
click node_system_environment "https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/sysenv.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_catalog,node_player_reports,node_developer_updates toneBlue
class node_assets,node_install,node_easy_setup,node_own_setup,node_roms,node_flatpak,node_system_environment toneAmber
class node_boot,node_library_store,node_games,node_profile,node_saves,node_cloud toneMint
class node_launcher_ui,node_looks,node_big_picture toneRose
class node_player toneIndigo
```

## Components

### Discovery and community

- [Catalog and releases](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/catalog.rs): `src-tauri/src/catalog.rs`
- [Player reports](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/usage.rs): `src-tauri/src/usage.rs`
- [Developer follows](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/devtools.rs): `src-tauri/src/devtools.rs`

### Install and setup

- [Build selection](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/assets.rs): `src-tauri/src/assets.rs`
- [Download and verify](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/install.rs): `src-tauri/src/install.rs`
- [Easy Setup inputs](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/inputs.rs): `src-tauri/src/inputs.rs`
- [Setup orchestration](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/own_setup.rs): `src-tauri/src/own_setup.rs`
- [Game-file handling](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/roms.rs): `src-tauri/src/roms.rs`
- [Linux packaging support](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/flatpak.rs): `src-tauri/src/flatpak.rs`
- [Platform environment](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/sysenv.rs): `src-tauri/src/sysenv.rs`

### Library and play

- [Launch profiles](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/boot.rs): `src-tauri/src/boot.rs`
- [Installed library](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/library.rs): `src-tauri/src/library.rs`
- [Multi-game titles](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/games.rs): `src-tauri/src/games.rs`
- [Game configuration](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/profile.rs): `src-tauri/src/profile.rs`
- [Save backups](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/saves.rs): `src-tauri/src/saves.rs`
- [Cloud saves](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/cloud.rs): `src-tauri/src/cloud.rs`

### Player experience

- [Launcher UI](https://github.com/elripalda/recomplauncher/blob/main/ui/app.js): `ui/app.js`
- [Per-game looks](https://github.com/elripalda/recomplauncher/blob/main/src-tauri/src/looks.rs): `src-tauri/src/looks.rs`
- [Big Picture](https://github.com/elripalda/recomplauncher/blob/main/ui/tv.js): `ui/tv.js`

### Other components

- **Player**

## Connections

- Player → Launcher UI: uses
- Launcher UI → Catalog and releases: discovers titles
- Catalog and releases → Build selection: offers releases (evidence: `src-tauri/src/catalog.rs`)
- Build selection → Download and verify: selects build (evidence: `src-tauri/src/install.rs`)
- Launcher UI → Download and verify: requests install
- Download and verify → Installed library: installs title (evidence: `src-tauri/src/install.rs`)
- Launcher UI → Easy Setup inputs: selects game files
- Setup orchestration → Download and verify: uses installer (evidence: `src-tauri/src/own_setup.rs`)
- Easy Setup inputs → Game configuration: reads setup rules (evidence: `src-tauri/src/inputs.rs`)
- Game configuration → Launch profiles: defines launch (evidence: `src-tauri/src/profile.rs`)
- Launcher UI → Installed library: manages library
- Installed library → Multi-game titles: tracks game entries (evidence: `src-tauri/src/library.rs`)
- Launcher UI → Save backups: backs up saves
- Save backups → Cloud saves: syncs saves (evidence: `src-tauri/src/cloud.rs`)
- Launcher UI → Per-game looks: chooses effects
- Player → Big Picture: uses controller mode
- Launcher UI → Player reports: views reports
- Launcher UI → Developer follows: follows developers
- Download and verify → Linux packaging support: supports Linux (evidence: `src-tauri/src/install.rs`)
- Download and verify → Platform environment: checks platform (evidence: `src-tauri/src/install.rs`)
- Easy Setup inputs → Game-file handling: handles game files
