How cl0ud-9/krate works
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: ArtifactDownloader.kt Artifact download · RemoteCatalogRepository.kt Catalog repository · ManifestCheckWorker.kt Background checks · KrateActivity.kt Activity entry
Components 25
App experience
- Activity entry
app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt - Navigation host
app/src/main/kotlin/dev/cl0ud9/krate/ui/navigation/KrateNavHost.kt - First-run setup
app/src/main/kotlin/dev/cl0ud9/krate/ui/onboarding/OnboardingScreen.kt - Apps browser
app/src/main/kotlin/dev/cl0ud9/krate/ui/apps/AppsScreen.kt - App details
app/src/main/kotlin/dev/cl0ud9/krate/ui/details/AppDetailsViewModel.kt - Preferences
app/src/main/kotlin/dev/cl0ud9/krate/ui/settings/SettingsViewModel.kt - Updates screen
app/src/main/kotlin/dev/cl0ud9/krate/ui/updates/UpdatesViewModel.kt
Catalog and updates
- Catalog repository
app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt - Manifest format
app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/ManifestDto.kt - Manifest verifier
app/src/main/kotlin/dev/cl0ud9/krate/security/manifest/ManifestVerifier.kt - Tracked sources
app/src/main/kotlin/dev/cl0ud9/krate/data/tracked/TrackedAppsRepository.kt
Download and install
- Artifact download
app/src/main/kotlin/dev/cl0ud9/krate/data/downloads/ArtifactDownloader.kt - APK checks
app/src/main/kotlin/dev/cl0ud9/krate/security/apk/SignerIdentity.kt - Update all engine
app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt - Install orchestration
app/src/main/kotlin/dev/cl0ud9/krate/domain/installer/CleanInstallOrchestrator.kt - Android installer
app/src/main/kotlin/dev/cl0ud9/krate/platform/packageinstaller/PackageInstallerEngine.kt
Platform services
- Background checks
app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt - Auto-install worker
app/src/main/kotlin/dev/cl0ud9/krate/platform/autoupdate/AutoUpdateWorker.kt - Update notifications
app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/UpdateNotifier.kt - Settings storage
app/src/main/kotlin/dev/cl0ud9/krate/data/settings/DataStoreSettingsRepository.kt - Settings backup
app/src/main/kotlin/dev/cl0ud9/krate/platform/backup/KrateBackupService.kt - Krate self-update
app/src/main/kotlin/dev/cl0ud9/krate/platform/selfupdate/KrateUpdateChecker.kt
Other components
- App user
- Release hosts
- Android package manager
Connections 30
- App user → Activity entry: opens
- Activity entry → Navigation host: hosts
app/src/main/kotlin/dev/cl0ud9/krate/KrateActivity.kt - Activity entry → First-run setup: launches
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
app/src/main/kotlin/dev/cl0ud9/krate/data/catalog/RemoteCatalogRepository.kt - Catalog repository → Manifest verifier: verifies signature
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
app/src/main/kotlin/dev/cl0ud9/krate/domain/updateall/UpdateAllEngine.kt - Update all engine → Install orchestration: installs updates
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
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
app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt - Background checks → Update notifications: notifies updates
app/src/main/kotlin/dev/cl0ud9/krate/platform/workers/ManifestCheckWorker.kt - Auto-install worker → Artifact download: reuses ready files
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