CLAUDE.md

1# Tweaks Feature
2 
3Single home for every app-level setting. Update prefs, installer choice (Default / Shizuku / Dhizuku / Root), telemetry, translation, mirror, feedback, hidden + skipped list managers. Absorbs settings half of former `feature/profile/`.
4 
5## Structure
6 
7```
8feature/tweaks/presentation/
9├── TweaksViewModel / State / Action / Event / Root, RestartApp
10├── components/
11│   ├── sections/  Account, Appearance, Installation, Language, Network, Others, Translation, SettingsSection
12│   └── ToggleSettingCard, ClearDownloadsDialog, SectionText, CustomForgesDialog
13├── feedback/      # FeedbackViewModel + sheet
14├── hidden/        # HiddenRepositoriesRoot — Tweaks → Updates → Hidden repos
15├── skipped/       # SkippedUpdatesRoot — Tweaks → Updates → Skipped updates
16├── hosttokens/    # HostTokensRoot/ViewModel — Tweaks → Access Tokens (per-host PATs)
17├── mirror/        # MirrorPickerRoot — Tweaks → Network → Mirror picker
18└── model/         # ProxyScopeFormState, ProxyType
19```
20 
21## Sub-screen VMs (registered in `composeApp/.../app/di/ViewModelsModule.kt`)
22 
23`SkippedUpdatesViewModel` (unskip via `InstalledAppsRepository.setSkippedReleaseTag`), `HiddenRepositoriesViewModel` (unhide / unhide-all via `HiddenReposRepository`), `HostTokensViewModel` (CRUD on `HostTokenRepository`), `FeedbackViewModel`, `AutoSuggestMirrorViewModel`, `MirrorPickerViewModel`.
24 
25## Navigation
26 
27`TweaksScreen`, `SkippedUpdatesScreen`, `HiddenRepositoriesScreen`, `HostTokensScreen`, `MirrorPickerScreen`.
28 
29## Notes
30 
31- TweaksViewModel injects: `TweaksRepository`, `ThemesRepository`, `ProxyRepository`, `InstalledAppsRepository`, `ProfileRepository`, `InstallerStatusProvider`, `TelemetryRepository`, `Platform`, `BatteryOptimizationManager` (Android), `GitHubStoreLogger`.
32- One-shot coachmark flags in `TweaksRepository` (`apk_inspect_coachmark_shown`, `channel_chip_coachmark_shown`). Once persisted true, never re-shown.
33- `include_pre_releases` pref read by `InstallationManagerImpl` to seed new install's `InstalledApp.includePreReleases`. Existing rows keep per-app value.
34- `show_all_platforms` pref drives cross-platform asset section in Details.
35- Mirror picker gated on user locale (suggested in throttled regions).
36- **Appearance → Content width (desktop):** `ContentWidthCard` picks `ContentWidth` (`COMPACT` / `WIDE` / `EXTRA_WIDE`); written via `OnContentWidthSelected` action; consumed by `LocalContentWidth` in Details.
37- **Network → Custom forges:** `CustomForgesDialog` (opened via `OnOpenCustomForgesDialog`) edits `state.customForgeHosts` (persisted via `TweaksRepository`). Hosts surface in `RepositoryUrlParser` + power `SearchSourceUi.Custom` chips + register Ktor clients in `ForgejoClientRegistry`.
38- **Access Tokens (`HostTokensScreen`):** sub-screen lists / adds / edits / deletes per-host PATs in `HostTokenRepository` (AES-256-GCM via KSafe). Token surfaces via `HostTokenInterceptor` on matched host (`api.github.com → github.com` mapped through `HostNames.apiHostToTokenHost`).
39- **Translation section:** `AutoTranslateCard` toggles `OnAutoTranslateEnabledToggle` + picks target via `OnAutoTranslateTargetSelected`. Per-provider credential forms — `LibreTranslateCredentialsForm` (base URL + API key, defaults to `translate.disroot.org` mirror when blank), `MicrosoftCredentialsForm` (key + region; Azure portal deep-link); DeepL key field auto-routes `:fx` suffix to free endpoint. All credentials persisted via `TweaksRepository` (KSafe-encrypted), visibility toggles per field.
40- `RestartApp.kt` applies locale change (persist tag, restart MainActivity / DesktopApp).
41