# zhayi-miao/qookix-launcher-android architecture

> Architecture diagram of the GitHub repository zhayi-miao/qookix-launcher-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zhayi-miao/qookix-launcher-android
- Repository: https://github.com/zhayi-miao/qookix-launcher-android

## Overview

QookiX is an Android launcher for Minecraft: Java Edition. The main workflow is to sign in, create or select an isolated game instance, obtain game/loader and Java files, then launch the game through the Android JVM and rendering layer. The UI also supports content discovery, instance files and backups, multiplayer, skins, and settings. The README documents these capabilities; source excerpts and the index establish selected UI-to-command and native-layer relationships, so links for unsampled Rust subsystems are documented rather than inferred from filenames.

Main entry points: [`src/api.ts`](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/api.ts) (Command API), [`src/router.ts`](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/router.ts) (Screen Router), [`app/src/main/java/com/zhayi/qookix/GameActivity.kt`](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/GameActivity.kt) (Game Activity), [`src-tauri/src/instances.rs`](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/instances.rs) (Instance Management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Launcher UI"]
  node_app["App Shell<br/>[App.vue]"]
  node_routes["Screen Router<br/>[router.ts]"]
  node_instances_ui["Instance Screens<br/>[InstancesView.vue]"]
  node_detail_ui["Instance Detail"]
  node_settings_ui["Settings<br/>[SettingsView.vue]"]
  node_api["Command API<br/>[api.ts]"]
end

subgraph group_backend["Rust Services"]
  node_accounts["Accounts<br/>[accounts.rs]"]
  node_instances["Instance Management<br/>[instances.rs]"]
  node_downloads["Downloads<br/>[download.rs]"]
  node_java["Java Runtime<br/>[java.rs]"]
  node_launch["Game Launch<br/>[launch.rs]"]
  node_settings["Settings and Models<br/>[settings.rs]"]
  node_files["Instance Files<br/>[instance_files.rs]"]
  node_backups["World Backups<br/>[world_backup.rs]"]
end

subgraph group_game["Android Game Runtime"]
  node_native_activity["Game Activity<br/>[GameActivity.kt]"]
  node_game_service["Game Service<br/>[GameService.kt]"]
  node_input["Touch Input<br/>[InputDispatcher.kt]"]
  node_surface["Game Surface<br/>[GameSurfaceView.kt]"]
  node_tauri_bridge["Tauri Bridge<br/>[TauriBridge.kt]"]
end

subgraph group_content["Content and Multiplayer"]
  node_browse_ui["Content Browser<br/>[BrowseView.vue]"]
  node_multiplayer_ui["Multiplayer Screens"]
  node_browse["Browse and Install<br/>[browse.rs]"]
  node_servers["Server Management<br/>[servers.rs]"]
end

node_user(("Player"))
node_minecraft{{"Minecraft Runtime"}}
node_platforms(("Modrinth / CurseForge"))

node_user -->|"uses"| node_app
node_app -->|"displays"| node_routes
node_routes -->|"routes to"| node_instances_ui
node_routes -->|"routes to"| node_detail_ui
node_routes -->|"routes to"| node_browse_ui
node_routes -->|"routes to"| node_multiplayer_ui
node_routes -->|"routes to"| node_settings_ui
node_instances_ui -.->|"requests commands"| node_api
node_detail_ui -.->|"requests commands"| node_api
node_browse_ui -.->|"requests commands"| node_api
node_multiplayer_ui -.->|"requests commands"| node_api
node_settings_ui -.->|"requests commands"| node_api
node_api -->|"invokes commands"| node_instances
node_api -->|"invokes commands"| node_accounts
node_api -.->|"invokes commands"| node_browse
node_api -.->|"invokes commands"| node_settings
node_api -.->|"invokes commands"| node_files
node_api -.->|"invokes commands"| node_backups
node_api -.->|"invokes commands"| node_servers
node_browse -.->|"searches and installs"| node_platforms
node_instances -.->|"obtains game files"| node_downloads
node_instances -.->|"obtains runtime"| node_java
node_user -.->|"plays on device"| node_native_activity
node_native_activity -->|"starts game service"| node_game_service
node_native_activity -->|"dispatches input"| node_input
node_native_activity -->|"uses surface"| node_surface
node_native_activity -->|"uses bridge"| node_tauri_bridge
node_launch -.->|"launches"| node_minecraft
node_game_service -.->|"hosts runtime"| node_minecraft
node_surface -.->|"renders"| node_minecraft

click node_app "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/App.vue"
click node_routes "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/router.ts"
click node_instances_ui "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/InstancesView.vue"
click node_detail_ui "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/InstanceDetailView.vue"
click node_settings_ui "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/SettingsView.vue"
click node_browse_ui "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/BrowseView.vue"
click node_multiplayer_ui "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/MultiplayerView.vue"
click node_api "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/api.ts"
click node_accounts "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/accounts.rs"
click node_instances "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/instances.rs"
click node_browse "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/browse.rs"
click node_downloads "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/download.rs"
click node_java "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/java.rs"
click node_launch "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/launch.rs"
click node_settings "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/settings.rs"
click node_files "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/instance_files.rs"
click node_backups "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/world_backup.rs"
click node_servers "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/servers.rs"
click node_native_activity "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/GameActivity.kt"
click node_game_service "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/services/GameService.kt"
click node_input "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/control/InputDispatcher.kt"
click node_surface "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/render/GameSurfaceView.kt"
click node_tauri_bridge "https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/tauri/TauriBridge.kt"

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_routes,node_instances_ui,node_detail_ui,node_settings_ui,node_api toneBlue
class node_accounts,node_instances,node_downloads,node_java,node_launch,node_settings,node_files,node_backups toneAmber
class node_native_activity,node_game_service,node_input,node_surface,node_tauri_bridge toneMint
class node_browse_ui,node_multiplayer_ui,node_browse,node_servers toneRose
class node_user,node_minecraft,node_platforms toneIndigo
```

## Components

### Launcher UI

- [App Shell](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/App.vue): `src/App.vue`
- [Screen Router](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/router.ts): `src/router.ts`
- [Instance Screens](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/InstancesView.vue): `src/views/InstancesView.vue`
- [Instance Detail](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/InstanceDetailView.vue): `src/views/InstanceDetailView.vue`
- [Settings](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/SettingsView.vue): `src/views/SettingsView.vue`
- [Command API](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/api.ts): `src/api.ts`

### Rust Services

- [Accounts](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/accounts.rs): `src-tauri/src/accounts.rs`
- [Instance Management](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/instances.rs): `src-tauri/src/instances.rs`
- [Downloads](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/download.rs): `src-tauri/src/download.rs`
- [Java Runtime](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/java.rs): `src-tauri/src/java.rs`
- [Game Launch](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/launch.rs): `src-tauri/src/launch.rs`
- [Settings and Models](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/settings.rs): `src-tauri/src/settings.rs`
- [Instance Files](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/instance_files.rs): `src-tauri/src/instance_files.rs`
- [World Backups](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/world_backup.rs): `src-tauri/src/world_backup.rs`

### Android Game Runtime

- [Game Activity](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/GameActivity.kt): `app/src/main/java/com/zhayi/qookix/GameActivity.kt`
- [Game Service](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/services/GameService.kt): `app/src/main/java/com/zhayi/qookix/services/GameService.kt`
- [Touch Input](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/control/InputDispatcher.kt): `app/src/main/java/com/zhayi/qookix/control/InputDispatcher.kt`
- [Game Surface](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/render/GameSurfaceView.kt): `app/src/main/java/com/zhayi/qookix/render/GameSurfaceView.kt`
- [Tauri Bridge](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/app/src/main/java/com/zhayi/qookix/tauri/TauriBridge.kt): `app/src/main/java/com/zhayi/qookix/tauri/TauriBridge.kt`

### Content and Multiplayer

- [Content Browser](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/BrowseView.vue): `src/views/BrowseView.vue`
- [Multiplayer Screens](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src/views/MultiplayerView.vue): `src/views/MultiplayerView.vue`
- [Browse and Install](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/browse.rs): `src-tauri/src/browse.rs`
- [Server Management](https://github.com/zhayi-miao/qookix-launcher-android/blob/master/src-tauri/src/servers.rs): `src-tauri/src/servers.rs`

### Other components

- **Player**
- **Minecraft Runtime**
- **Modrinth / CurseForge**

## Connections

- Player → App Shell: uses
- App Shell → Screen Router: displays (evidence: `src/App.vue`)
- Screen Router → Instance Screens: routes to (evidence: `src/router.ts`)
- Screen Router → Instance Detail: routes to (evidence: `src/router.ts`)
- Screen Router → Content Browser: routes to (evidence: `src/router.ts`)
- Screen Router → Multiplayer Screens: routes to (evidence: `src/router.ts`)
- Screen Router → Settings: routes to (evidence: `src/router.ts`)
- Instance Screens → Command API: requests commands
- Instance Detail → Command API: requests commands
- Content Browser → Command API: requests commands
- Multiplayer Screens → Command API: requests commands
- Settings → Command API: requests commands
- Command API → Instance Management: invokes commands (evidence: `src/api.ts`)
- Command API → Accounts: invokes commands (evidence: `src/api.ts`)
- Command API → Browse and Install: invokes commands
- Command API → Settings and Models: invokes commands
- Command API → Instance Files: invokes commands
- Command API → World Backups: invokes commands
- Command API → Server Management: invokes commands
- Browse and Install → Modrinth / CurseForge: searches and installs
- Instance Management → Downloads: obtains game files
- Instance Management → Java Runtime: obtains runtime
- Player → Game Activity: plays on device
- Game Activity → Game Service: starts game service (evidence: `app/src/main/java/com/zhayi/qookix/GameActivity.kt`)
- Game Activity → Touch Input: dispatches input (evidence: `app/src/main/java/com/zhayi/qookix/GameActivity.kt`)
- Game Activity → Game Surface: uses surface (evidence: `app/src/main/java/com/zhayi/qookix/GameActivity.kt`)
- Game Activity → Tauri Bridge: uses bridge (evidence: `app/src/main/java/com/zhayi/qookix/GameActivity.kt`)
- Game Launch → Minecraft Runtime: launches
- Game Service → Minecraft Runtime: hosts runtime
- Game Surface → Minecraft Runtime: renders
