Repository navigation
ShellGuard TOTP v0.0.2.0
π¦ ShellGuard TOTP β Release v0.0.2.0 (Build 10)
Milestone 2: The Categorized Settings Hub
βββββββββββ ββββββββββββββ βββ βββββββ βββ βββ ββββββ βββββββ βββββββ
βββββββββββ ββββββββββββββ βββ βββββββ βββ βββ ββββββββ ββββββββ ββββββββ
ββββββββββββββββββββββ βββ βββ βββ ββββ βββ βββ ββββββββ ββββββββ βββ βββ
ββββββββββββββββββββββ βββ βββ βββ βββ βββ βββ ββββββββ ββββββββ βββ βββ
βββββββββββ βββββββββββββββββββ βββββββββββββββββ βββ βββ βββ βββ ββββββββ
βββββββββββ βββββββββββββββββββββββββββ βββ βββ βββ βββ βββ βββ
~ **ClawStack Mobile StudiosΒ©β’** ~
π The Core Summary
Welcome to v0.0.2.0 of ShellGuard-TOTP β Milestone 2 of the post-launch expansion. The monolithic settings page is now a fully Categorized Settings Hub: seven preference sections with dedicated sub-screens for Appearance and Behavior, every control backed by structured preference stores that apply changes to the dashboard instantly β no restart, no re-login. 101/101 tests green.
π Key Themes & Highlights
π¨ 1. Categorized Settings Hub
SettingsMetaScreen: Seven preference categories (π¨ Appearance, β‘ Behavior, π¦ Icon packs, π Security, βοΈ Backups, π οΈ Import & Export, π Audit log) with icons and descriptive subtitles in Reef Modernist cards.- Honest Roadmap UX: Categories whose sub-screens ship in Phases 12β14 route to clearly-labeled in-app placeholders with a bridge to server/backup settings β no dead ends.
β‘ 2. Preferences Store Architecture (Task 21)
- Structured stores:
AppearancePreferences(view mode, issuer icons, next-code preview, expiration blink, digit grouping, issuer/account display rules, Group Manager hidden-groups) andBehaviorPreferences(search scope, focus search on start, minimize on copy, copy on tap, haptics, multiselect groups, highlight & freeze tokens). - Durable persistence: SharedPreferences-backed
StateFlows with corrupt-value fallback and persistence across process recreation; 14 granular setters. - Regression armor:
UserPreferencesStoreTest(5 cases) covering defaults, synchronous flow updates, recreation persistence, group management, and corrupt-enum fallback.
ποΈ 3. Live Dashboard Application (Task 22)
- Digit grouping & haptic feedback drive
TotpCardrendering and interaction directly. - Search scope (All/Local/Synced) and hidden groups filter dashboard streams reactively via
combinechains. - Focus search on start focuses the dashboard search bar through a
FocusRequester. SettingsAppearanceScreen&SettingsBehaviorScreen: full sub-screens with segmented selectors and switches, all live StateFlow-backed.
β Verification Gate
- 101/101 unit & Robolectric tests passing (100% green)
assembleDebugsuccessful- Live on-device verification: Settings Hub, Appearance & Behavior sub-screens captured from a physical Pixel (README screenshots refreshed)
π¦ Upgrade Notes
versionCode9 β 10 (monotonic Play Console invariant);versionName"0.0.2.0"- No schema migration required; existing preferences carry over untouched
- Milestone 2 of the post-launch roadmap β next stop: Phase 12 Security Suite (v0.0.2.1)