# akyrayy/akylauncher architecture

> Architecture diagram of the GitHub repository akyrayy/akylauncher, 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/akyrayy/akylauncher
- Repository: https://github.com/akyrayy/akylauncher

## Overview

AkyLauncher is an Electron desktop launcher for Minecraft. The user selects or creates a profile, chooses a game version, and launches; the launcher prepares Java and game files, then streams progress and logs to the UI. The renderer also exposes profile, mod, settings, theme, console, and (in the current source tree) hosting, server, and world features. The IPC router is the main-process dispatch layer. Some feature modules are represented from the source index and README rather than inspected implementation; edges are limited to documented or indexed relationships.

Main entry points: [`src/main/ipc/router.ts`](https://github.com/akyrayy/akylauncher/blob/main/src/main/ipc/router.ts) (IPC router), [`src/renderer/src/App.tsx`](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/App.tsx) (Screen shell), [`src/renderer/src/state/store.ts`](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/state/store.ts) (Renderer state), [`src/main/core/bootstrap.ts`](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/bootstrap.ts) (Bootstrap and launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["Screen shell<br/>[App.tsx]"]
  node_home["Home and launch<br/>[Home.tsx]"]
  node_versions_ui["Version picker<br/>[Versions.tsx]"]
  node_profiles_ui["Profiles UI<br/>[Profiles.tsx]"]
  node_mods_ui["Mod catalog UI<br/>[Mods.tsx]"]
  node_settings_ui["Settings UI<br/>[Settings.tsx]"]
  node_console_ui["Game console<br/>[Console.tsx]"]
  node_hosting_ui["Hosting UI<br/>[Hosting.tsx]"]
  node_servers_ui["Servers UI<br/>[Servers.tsx]"]
  node_worlds_ui["Worlds UI<br/>[Worlds.tsx]"]
  node_renderer_state["Renderer state<br/>[store.ts]"]
end

subgraph group_ipc["IPC boundary"]
  node_renderer_bridge["Renderer bridge<br/>[bridge.ts]"]
  node_preload["Preload API<br/>[index.ts]"]
  node_ipc_router["IPC router<br/>[router.ts]"]
  node_main_process["Electron main<br/>[index.ts]"]
end

subgraph group_game["Game lifecycle"]
  node_launch["Bootstrap and launch<br/>[bootstrap.ts]"]
  node_versions["Version management<br/>[versions.ts]"]
  node_java["Java runtime<br/>[java.ts]"]
  node_download["Game downloads<br/>[download.ts]"]
end

subgraph group_content["Profiles and content"]
  node_instances["Game instances<br/>[instances.ts]"]
  node_profiles["Player profiles<br/>[profiles.ts]"]
  node_modrinth["Modrinth catalog<br/>[modrinth.ts]"]
  node_mrpack["Modpack import<br/>[mrpack.ts]"]
  node_worlds["World management<br/>[worlds.ts]"]
  node_servers["Server management<br/>[servers.ts]"]
  node_hosting["Server hosting<br/>[hosting.ts]"]
end

subgraph group_services["Integrations and tools"]
  node_settings["Launcher settings<br/>[settings.ts]"]
  node_auth["Offline authentication<br/>[auth.ts]"]
  node_skins["Skin management<br/>[skins.ts]"]
  node_ai["Crash and mod AI<br/>[ai.ts]"]
  node_discord["Discord presence<br/>[discord.ts]"]
  node_updater["Release updates<br/>[updater.ts]"]
  node_sync["Launcher sync<br/>[sync.ts]"]
end

node_user(("Player"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_home
node_app -->|"renders"| node_versions_ui
node_app -->|"renders"| node_profiles_ui
node_app -->|"renders"| node_mods_ui
node_app -->|"renders"| node_settings_ui
node_app -->|"renders"| node_console_ui
node_app -->|"renders"| node_hosting_ui
node_app -->|"renders"| node_servers_ui
node_app -->|"renders"| node_worlds_ui
node_app -->|"reads state"| node_renderer_state
node_renderer_state -->|"invokes"| node_renderer_bridge
node_main_process -->|"registers"| node_ipc_router
node_ipc_router -->|"dispatches to"| node_instances
node_ipc_router -->|"dispatches to"| node_profiles
node_ipc_router -->|"dispatches to"| node_versions
node_ipc_router -->|"dispatches to"| node_launch
node_ipc_router -->|"dispatches to"| node_java
node_ipc_router -->|"dispatches to"| node_settings
node_ipc_router -->|"dispatches to"| node_modrinth
node_ipc_router -->|"dispatches to"| node_auth
node_ipc_router -->|"dispatches to"| node_skins
node_ipc_router -->|"dispatches to"| node_updater
node_ipc_router -->|"dispatches to"| node_discord
node_ipc_router -->|"dispatches to"| node_ai
node_ipc_router -->|"dispatches to"| node_mrpack
node_ipc_router -->|"dispatches to"| node_sync
node_ipc_router -->|"dispatches to"| node_hosting
node_ipc_router -->|"dispatches to"| node_worlds
node_ipc_router -->|"dispatches to"| node_servers
node_launch -.->|"starts game"| node_user

click node_app "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/App.tsx"
click node_home "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Home.tsx"
click node_versions_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Versions.tsx"
click node_profiles_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Profiles.tsx"
click node_mods_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Mods.tsx"
click node_settings_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Settings.tsx"
click node_console_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Console.tsx"
click node_hosting_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Hosting.tsx"
click node_servers_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Servers.tsx"
click node_worlds_ui "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Worlds.tsx"
click node_renderer_state "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/state/store.ts"
click node_renderer_bridge "https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/bridge.ts"
click node_preload "https://github.com/akyrayy/akylauncher/blob/main/src/preload/index.ts"
click node_ipc_router "https://github.com/akyrayy/akylauncher/blob/main/src/main/ipc/router.ts"
click node_main_process "https://github.com/akyrayy/akylauncher/blob/main/src/main/index.ts"
click node_launch "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/bootstrap.ts"
click node_versions "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/versions.ts"
click node_java "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/java.ts"
click node_download "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/download.ts"
click node_instances "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/instances.ts"
click node_profiles "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/profiles.ts"
click node_modrinth "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/modrinth.ts"
click node_mrpack "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/mrpack.ts"
click node_worlds "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/worlds.ts"
click node_servers "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/servers.ts"
click node_hosting "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/hosting.ts"
click node_settings "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/settings.ts"
click node_auth "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/auth.ts"
click node_skins "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/skins.ts"
click node_ai "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/ai.ts"
click node_discord "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/discord.ts"
click node_updater "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/updater.ts"
click node_sync "https://github.com/akyrayy/akylauncher/blob/main/src/main/core/sync.ts"

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_home,node_versions_ui,node_profiles_ui,node_mods_ui,node_settings_ui,node_console_ui,node_hosting_ui,node_servers_ui,node_worlds_ui,node_renderer_state toneBlue
class node_renderer_bridge,node_preload,node_ipc_router,node_main_process toneAmber
class node_launch,node_versions,node_java,node_download toneMint
class node_instances,node_profiles,node_modrinth,node_mrpack,node_worlds,node_servers,node_hosting toneRose
class node_settings,node_auth,node_skins,node_ai,node_discord,node_updater,node_sync,node_user toneIndigo
```

## Components

### Desktop interface

- [Screen shell](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/App.tsx): `src/renderer/src/App.tsx`
- [Home and launch](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Home.tsx): `src/renderer/src/screens/Home.tsx`
- [Version picker](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Versions.tsx): `src/renderer/src/screens/Versions.tsx`
- [Profiles UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Profiles.tsx): `src/renderer/src/screens/Profiles.tsx`
- [Mod catalog UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Mods.tsx): `src/renderer/src/screens/Mods.tsx`
- [Settings UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Settings.tsx): `src/renderer/src/screens/Settings.tsx`
- [Game console](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Console.tsx): `src/renderer/src/screens/Console.tsx`
- [Hosting UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Hosting.tsx): `src/renderer/src/screens/Hosting.tsx`
- [Servers UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Servers.tsx): `src/renderer/src/screens/Servers.tsx`
- [Worlds UI](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/screens/Worlds.tsx): `src/renderer/src/screens/Worlds.tsx`
- [Renderer state](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/state/store.ts): `src/renderer/src/state/store.ts`

### IPC boundary

- [Renderer bridge](https://github.com/akyrayy/akylauncher/blob/main/src/renderer/src/bridge.ts): `src/renderer/src/bridge.ts`
- [Preload API](https://github.com/akyrayy/akylauncher/blob/main/src/preload/index.ts): `src/preload/index.ts`
- [IPC router](https://github.com/akyrayy/akylauncher/blob/main/src/main/ipc/router.ts): `src/main/ipc/router.ts`
- [Electron main](https://github.com/akyrayy/akylauncher/blob/main/src/main/index.ts): `src/main/index.ts`

### Game lifecycle

- [Bootstrap and launch](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/bootstrap.ts): `src/main/core/bootstrap.ts`
- [Version management](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/versions.ts): `src/main/core/versions.ts`
- [Java runtime](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/java.ts): `src/main/core/java.ts`
- [Game downloads](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/download.ts): `src/main/core/download.ts`

### Profiles and content

- [Game instances](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/instances.ts): `src/main/core/instances.ts`
- [Player profiles](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/profiles.ts): `src/main/core/profiles.ts`
- [Modrinth catalog](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/modrinth.ts): `src/main/core/modrinth.ts`
- [Modpack import](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/mrpack.ts): `src/main/core/mrpack.ts`
- [World management](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/worlds.ts): `src/main/core/worlds.ts`
- [Server management](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/servers.ts): `src/main/core/servers.ts`
- [Server hosting](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/hosting.ts): `src/main/core/hosting.ts`

### Integrations and tools

- [Launcher settings](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/settings.ts): `src/main/core/settings.ts`
- [Offline authentication](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/auth.ts): `src/main/core/auth.ts`
- [Skin management](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/skins.ts): `src/main/core/skins.ts`
- [Crash and mod AI](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/ai.ts): `src/main/core/ai.ts`
- [Discord presence](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/discord.ts): `src/main/core/discord.ts`
- [Release updates](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/updater.ts): `src/main/core/updater.ts`
- [Launcher sync](https://github.com/akyrayy/akylauncher/blob/main/src/main/core/sync.ts): `src/main/core/sync.ts`

### Other components

- **Player**

## Connections

- Player → Screen shell: uses (evidence: `README.md`)
- Screen shell → Home and launch: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Version picker: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Profiles UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Mod catalog UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Settings UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Game console: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Hosting UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Servers UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Worlds UI: renders (evidence: `src/renderer/src/App.tsx`)
- Screen shell → Renderer state: reads state (evidence: `src/renderer/src/App.tsx`)
- Renderer state → Renderer bridge: invokes (evidence: `src/renderer/src/state/store.ts`)
- Electron main → IPC router: registers (evidence: `src/main/index.ts`)
- IPC router → Game instances: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Player profiles: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Version management: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Bootstrap and launch: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Java runtime: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Launcher settings: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Modrinth catalog: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Offline authentication: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Skin management: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Release updates: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Discord presence: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Crash and mod AI: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Modpack import: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Launcher sync: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Server hosting: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → World management: dispatches to (evidence: `src/main/ipc/router.ts`)
- IPC router → Server management: dispatches to (evidence: `src/main/ipc/router.ts`)
- Bootstrap and launch → Player: starts game
