# senjudspy/gradle architecture

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

- Interactive diagram: https://gitdiagram.com/senjudspy/gradle
- Repository: https://github.com/senjudspy/gradle

## Overview

Gradle is a desktop Minecraft launcher built around a Modrinth-style interface. The main user workflow is to sign in or use an offline account, create or choose an instance, obtain its content, and launch Minecraft; settings, skins, worlds, screenshots, sharing, and server management are additional product areas. The graph captures documented capabilities and relationships visible in sampled sources. Several frontend and native subsystems are represented by their exact tree directories because their implementation was not sampled.

Main entry points: [`apps/app-frontend/src`](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src) (Launcher interface), [`apps/app-frontend/src/pages/instance`](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/pages/instance) (Instance management), [`apps/app/src/api/instance.rs`](https://github.com/senjudspy/gradle/blob/master/apps/app/src/api/instance.rs) (Instance and file APIs), [`apps/app-frontend/src/components/ui/library`](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/library) (Instance library)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Launcher experience"]
  node_frontend["Launcher interface"]
  node_settings["Settings and appearance"]
  node_updates["Launcher updates"]
end

subgraph group_instances["Instances and content"]
  node_library["Instance library"]
  node_installation["Content installation<br/>[content-install.ts]"]
  node_downloads["Download manager"]
  node_instance_pages["Instance management"]
  node_worlds["Worlds and servers"]
end

subgraph group_services["Accounts and services"]
  node_accounts["Accounts and skins"]
  node_browse["Content browsing<br/>[browse-manager.ts]"]
  node_api_client["Modrinth API client<br/>[abstract-client.ts]"]
  node_sharing["Shared instances"]
  node_skins["Skin editing"]
end

subgraph group_native["Desktop runtime"]
  node_native_app["Desktop application<br/>[main.rs]"]
  node_instance_api["Instance and file APIs<br/>[instance.rs]"]
  node_content_store[("Managed content store")]
  node_horizon["Horizon server runtime<br/>[server.rs]"]
end

node_player(("Player"))

node_player -->|"uses"| node_frontend
node_frontend -.->|"signs in"| node_accounts
node_frontend -.->|"chooses instance"| node_library
node_library -.->|"opens instance"| node_instance_pages
node_frontend -.->|"browses content"| node_browse
node_browse -->|"requests data"| node_api_client
node_frontend -.->|"installs content"| node_installation
node_installation -.->|"tracks jobs"| node_downloads
node_downloads -.->|"reads job state"| node_instance_api
node_native_app -->|"registers APIs"| node_instance_api
node_instance_pages -.->|"manages sharing"| node_sharing
node_instance_pages -.->|"manages worlds"| node_worlds
node_frontend -.->|"edits skins"| node_skins
node_settings -.->|"configures appearance"| node_frontend
node_instance_api -.->|"uses store"| node_content_store
node_instance_pages -.->|"manages servers"| node_horizon

click node_frontend "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src"
click node_settings "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/settings"
click node_updates "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/updates"
click node_accounts "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/minecraft-accounts"
click node_browse "https://github.com/senjudspy/gradle/blob/master/packages/ui/src/layouts/shared/browse-tab/providers/browse-manager.ts"
click node_api_client "https://github.com/senjudspy/gradle/blob/master/packages/api-client/src/core/abstract-client.ts"
click node_library "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/library"
click node_installation "https://github.com/senjudspy/gradle/blob/master/apps/app-frontend/src/providers/content-install.ts"
click node_downloads "https://github.com/senjudspy/gradle/blob/master/apps/app-frontend/src/components/ui/download-manager/use-download-manager.ts"
click node_instance_pages "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/pages/instance"
click node_sharing "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/shared-instances"
click node_worlds "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/world"
click node_skins "https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/skin"
click node_native_app "https://github.com/senjudspy/gradle/blob/master/apps/app/src/main.rs"
click node_instance_api "https://github.com/senjudspy/gradle/blob/master/apps/app/src/api/instance.rs"
click node_content_store "https://github.com/senjudspy/gradle/tree/master/packages/app-lib/src/state/content_store"
click node_horizon "https://github.com/senjudspy/gradle/blob/master/packages/horizon-runtime/src/server.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_frontend,node_settings,node_updates toneBlue
class node_library,node_installation,node_downloads,node_instance_pages,node_worlds toneAmber
class node_accounts,node_browse,node_api_client,node_sharing,node_skins toneMint
class node_native_app,node_instance_api,node_content_store,node_horizon toneRose
class node_player toneIndigo
```

## Components

### Launcher experience

- [Launcher interface](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src): `apps/app-frontend/src`
- [Settings and appearance](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/settings): `apps/app-frontend/src/features/settings`
- [Launcher updates](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/updates): `apps/app-frontend/src/features/updates`

### Instances and content

- [Instance library](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/library): `apps/app-frontend/src/components/ui/library`
- [Content installation](https://github.com/senjudspy/gradle/blob/master/apps/app-frontend/src/providers/content-install.ts): `apps/app-frontend/src/providers/content-install.ts`
- [Download manager](https://github.com/senjudspy/gradle/blob/master/apps/app-frontend/src/components/ui/download-manager/use-download-manager.ts): `apps/app-frontend/src/components/ui/download-manager/use-download-manager.ts`
- [Instance management](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/pages/instance): `apps/app-frontend/src/pages/instance`
- [Worlds and servers](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/world): `apps/app-frontend/src/components/ui/world`

### Accounts and services

- [Accounts and skins](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/features/minecraft-accounts): `apps/app-frontend/src/features/minecraft-accounts`
- [Content browsing](https://github.com/senjudspy/gradle/blob/master/packages/ui/src/layouts/shared/browse-tab/providers/browse-manager.ts): `packages/ui/src/layouts/shared/browse-tab/providers/browse-manager.ts`
- [Modrinth API client](https://github.com/senjudspy/gradle/blob/master/packages/api-client/src/core/abstract-client.ts): `packages/api-client/src/core/abstract-client.ts`
- [Shared instances](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/shared-instances): `apps/app-frontend/src/components/ui/shared-instances`
- [Skin editing](https://github.com/senjudspy/gradle/tree/master/apps/app-frontend/src/components/ui/skin): `apps/app-frontend/src/components/ui/skin`

### Desktop runtime

- [Desktop application](https://github.com/senjudspy/gradle/blob/master/apps/app/src/main.rs): `apps/app/src/main.rs`
- [Instance and file APIs](https://github.com/senjudspy/gradle/blob/master/apps/app/src/api/instance.rs): `apps/app/src/api/instance.rs`
- [Managed content store](https://github.com/senjudspy/gradle/tree/master/packages/app-lib/src/state/content_store): `packages/app-lib/src/state/content_store`
- [Horizon server runtime](https://github.com/senjudspy/gradle/blob/master/packages/horizon-runtime/src/server.rs): `packages/horizon-runtime/src/server.rs`

### Other components

- **Player**

## Connections

- Player → Launcher interface: uses (evidence: `README.md`)
- Launcher interface → Accounts and skins: signs in
- Launcher interface → Instance library: chooses instance
- Instance library → Instance management: opens instance
- Launcher interface → Content browsing: browses content
- Content browsing → Modrinth API client: requests data (evidence: `packages/ui/src/layouts/shared/browse-tab/providers/browse-manager.ts`)
- Launcher interface → Content installation: installs content
- Content installation → Download manager: tracks jobs
- Download manager → Instance and file APIs: reads job state
- Desktop application → Instance and file APIs: registers APIs (evidence: `apps/app/src/main.rs`)
- Instance management → Shared instances: manages sharing
- Instance management → Worlds and servers: manages worlds
- Launcher interface → Skin editing: edits skins
- Settings and appearance → Launcher interface: configures appearance
- Instance and file APIs → Managed content store: uses store
- Instance management → Horizon server runtime: manages servers
