# cl0ud-9/krate architecture

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

## Overview

Krate is an Android app catalog and installer for release-hosted APKs. The main user journey is to browse or track an app, choose an update, download and verify its APK, then hand installation to Android; Update all and scheduled workers reuse those stages. Separate branches cover onboarding and preferences, backups and setup guidance, and Krate’s own updates. The graph uses README statements and source-index references for relationships; unsampled implementation details are not treated as inspected.

Main entry points: [`app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt`](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt) (Artifact download), [`app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt`](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt) (Catalog repository), [`app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt`](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt) (Background checks), [`app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt`](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt) (Activity entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_activity["Activity entry<br/>[KrateActivity.kt]"]
  node_navigation["Navigation host<br/>[KrateNavHost.kt]"]
  node_onboarding["First-run setup"]
  node_apps["Apps browser<br/>[AppsScreen.kt]"]
  node_details["App details"]
  node_settings["Preferences"]
  node_updates_ui["Updates screen"]
end

subgraph group_catalog["Catalog and updates"]
  node_catalog_repo["Catalog repository"]
  node_catalog_manifest["Manifest format<br/>[ManifestDto.kt]"]
  node_manifest_verify["Manifest verifier"]
  node_tracked_apps["Tracked sources"]
end

subgraph group_install["Download and install"]
  node_download["Artifact download"]
  node_apk_checks["APK checks<br/>[SignerIdentity.kt]"]
  node_update_all["Update all engine<br/>[UpdateAllEngine.kt]"]
  node_clean_install["Install orchestration"]
  node_installer["Android installer"]
end

subgraph group_platform["Platform services"]
  node_manifest_worker["Background checks"]
  node_auto_worker["Auto-install worker"]
  node_update_notifier["Update notifications<br/>[UpdateNotifier.kt]"]
  node_settings_store[("Settings storage")]
  node_backup_service["Settings backup"]
  node_self_update["Krate self-update"]
end

node_user(("App user"))
node_release_hosts{{"Release hosts"}}
node_android{{"Android package manager"}}

node_user -->|"opens"| node_activity
node_activity -->|"hosts"| node_navigation
node_activity -->|"launches"| node_onboarding
node_user -->|"browses"| node_apps
node_apps -.->|"loads catalog"| node_catalog_repo
node_user -->|"selects app"| node_details
node_details -.->|"requests APK"| node_download
node_release_hosts -->|"publishes releases"| node_catalog_repo
node_catalog_repo -->|"parses manifest"| node_catalog_manifest
node_catalog_repo -->|"verifies signature"| node_manifest_verify
node_user -->|"adds release link"| node_tracked_apps
node_tracked_apps -->|"checks releases"| node_release_hosts
node_download -->|"fetches APK"| node_release_hosts
node_download -->|"checks hash and signer"| node_apk_checks
node_user -->|"starts update all"| node_update_all
node_update_all -->|"downloads artifacts"| node_download
node_update_all -->|"installs updates"| node_clean_install
node_clean_install -.->|"runs install steps"| node_installer
node_installer -->|"submits APK"| node_android
node_settings -.->|"reads and writes"| node_settings_store
node_manifest_worker -->|"refreshes catalog"| node_catalog_repo
node_manifest_worker -.->|"pre-downloads updates"| node_download
node_manifest_worker -->|"queues due installs"| node_auto_worker
node_manifest_worker -->|"notifies updates"| node_update_notifier
node_auto_worker -->|"reuses ready files"| node_download
node_auto_worker -->|"hands off installs"| node_android
node_user -->|"enables backups"| node_backup_service
node_user -->|"configures app"| node_settings
node_user -->|"updates Krate"| node_self_update
node_self_update -->|"checks own releases"| node_release_hosts

click node_activity "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt"
click node_navigation "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/navigation/KrateNavHost.kt"
click node_onboarding "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/onboarding/OnboardingScreen.kt"
click node_apps "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/apps/AppsScreen.kt"
click node_details "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/details/AppDetailsViewModel.kt"
click node_settings "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/settings/SettingsViewModel.kt"
click node_updates_ui "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/updates/UpdatesViewModel.kt"
click node_catalog_repo "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt"
click node_catalog_manifest "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/ManifestDto.kt"
click node_manifest_verify "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/security/manifest/ManifestVerifier.kt"
click node_tracked_apps "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/tracked/TrackedAppsRepository.kt"
click node_download "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt"
click node_apk_checks "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/security/apk/SignerIdentity.kt"
click node_update_all "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt"
click node_clean_install "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/domain/installer/CleanInstallOrchestrator.kt"
click node_installer "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/packageinstaller/PackageInstallerEngine.kt"
click node_manifest_worker "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt"
click node_auto_worker "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/autoupdate/AutoUpdateWorker.kt"
click node_update_notifier "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/UpdateNotifier.kt"
click node_settings_store "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/settings/DataStoreSettingsRepository.kt"
click node_backup_service "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/backup/KrateBackupService.kt"
click node_self_update "https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/selfupdate/KrateUpdateChecker.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_activity,node_navigation,node_onboarding,node_apps,node_details,node_settings,node_updates_ui,node_user toneBlue
class node_catalog_repo,node_catalog_manifest,node_manifest_verify,node_tracked_apps toneAmber
class node_download,node_apk_checks,node_update_all,node_clean_install,node_installer toneMint
class node_manifest_worker,node_auto_worker,node_update_notifier,node_settings_store,node_backup_service,node_self_update toneRose
class node_release_hosts,node_android toneIndigo
```

## Components

### App experience

- [Activity entry](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt): `app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt`
- [Navigation host](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/navigation/KrateNavHost.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/navigation/KrateNavHost.kt`
- [First-run setup](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/onboarding/OnboardingScreen.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/onboarding/OnboardingScreen.kt`
- [Apps browser](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/apps/AppsScreen.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/apps/AppsScreen.kt`
- [App details](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/details/AppDetailsViewModel.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/details/AppDetailsViewModel.kt`
- [Preferences](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/settings/SettingsViewModel.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/settings/SettingsViewModel.kt`
- [Updates screen](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/ui/updates/UpdatesViewModel.kt): `app/src/main/kotlin/dev/cl0ud9/krate/ui/updates/UpdatesViewModel.kt`

### Catalog and updates

- [Catalog repository](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt): `app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt`
- [Manifest format](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/ManifestDto.kt): `app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/ManifestDto.kt`
- [Manifest verifier](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/security/manifest/ManifestVerifier.kt): `app/src/main/kotlin/dev/cl0ud9/krate/security/manifest/ManifestVerifier.kt`
- [Tracked sources](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/tracked/TrackedAppsRepository.kt): `app/src/main/kotlin/dev/cl0ud9/krate/data/tracked/TrackedAppsRepository.kt`

### Download and install

- [Artifact download](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt): `app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt`
- [APK checks](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/security/apk/SignerIdentity.kt): `app/src/main/kotlin/dev/cl0ud9/krate/security/apk/SignerIdentity.kt`
- [Update all engine](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt): `app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt`
- [Install orchestration](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/domain/installer/CleanInstallOrchestrator.kt): `app/src/main/kotlin/dev/cl0ud9/krate/domain/installer/CleanInstallOrchestrator.kt`
- [Android installer](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/packageinstaller/PackageInstallerEngine.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/packageinstaller/PackageInstallerEngine.kt`

### Platform services

- [Background checks](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt`
- [Auto-install worker](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/autoupdate/AutoUpdateWorker.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/autoupdate/AutoUpdateWorker.kt`
- [Update notifications](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/UpdateNotifier.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/UpdateNotifier.kt`
- [Settings storage](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/data/settings/DataStoreSettingsRepository.kt): `app/src/main/kotlin/dev/cl0ud9/krate/data/settings/DataStoreSettingsRepository.kt`
- [Settings backup](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/backup/KrateBackupService.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/backup/KrateBackupService.kt`
- [Krate self-update](https://github.com/cl0ud-9/krate/blob/main/app/src/main/kotlin/dev/cl0ud9/krate/platform/selfupdate/KrateUpdateChecker.kt): `app/src/main/kotlin/dev/cl0ud9/krate/platform/selfupdate/KrateUpdateChecker.kt`

### Other components

- **App user**
- **Release hosts**
- **Android package manager**

## Connections

- App user → Activity entry: opens
- Activity entry → Navigation host: hosts (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt`)
- Activity entry → First-run setup: launches (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt`)
- App user → Apps browser: browses
- Apps browser → Catalog repository: loads catalog
- App user → App details: selects app
- App details → Artifact download: requests APK
- Release hosts → Catalog repository: publishes releases
- Catalog repository → Manifest format: parses manifest (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt`)
- Catalog repository → Manifest verifier: verifies signature (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt`)
- App user → Tracked sources: adds release link
- Tracked sources → Release hosts: checks releases
- Artifact download → Release hosts: fetches APK
- Artifact download → APK checks: checks hash and signer
- App user → Update all engine: starts update all
- Update all engine → Artifact download: downloads artifacts (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt`)
- Update all engine → Install orchestration: installs updates (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt`)
- Install orchestration → Android installer: runs install steps
- Android installer → Android package manager: submits APK
- Preferences → Settings storage: reads and writes
- Background checks → Catalog repository: refreshes catalog (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt`)
- Background checks → Artifact download: pre-downloads updates
- Background checks → Auto-install worker: queues due installs (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt`)
- Background checks → Update notifications: notifies updates (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt`)
- Auto-install worker → Artifact download: reuses ready files (evidence: `app/src/main/kotlin/dev/cl0ud9/krate/platform/autoupdate/AutoUpdateWorker.kt`)
- Auto-install worker → Android package manager: hands off installs
- App user → Settings backup: enables backups
- App user → Preferences: configures app
- App user → Krate self-update: updates Krate
- Krate self-update → Release hosts: checks own releases
