History / Design System

docs: update for v3.8-beta.9 — Dynamic Colors enabled Design-System.md: the opening claim that Dynamic Colors are "deliberately disabled" for brand monochrome is now wrong as of v3.8-beta.9. Replaced with the actual state: DynamicColors. applyToActivitiesIfAvailable() is wired in VarisankyaApplication, M3 tokens derive from the user's wallpaper on Android 12+, static fallbacks on older devices. Also removed the "no dynamic colour" bullet from the "what we deliberately don't do" list. Kept a brief historical note explaining the reversal so future readers can trace the change. Release-Timeline.md: added the v3.8-beta.9 row. Also annotated beta.8 retrospectively — its FAB fix was incomplete; the real fix was Dynamic Colors in beta.9 giving genuinely-contrasting colorPrimary/colorOnPrimary tokens.

Aarsh committed May 25, 2026

docs: rewrite wiki for the main-branch Varisankya subscription tracker The previous wiki content was written when this repo still had the minimal master starter (Hello-World + Google Sign-In). It documented the wrong app. This rewrite replaces every page with content that matches the v3.8-beta.8 Varisankya subscription tracker on main. New / replaced pages (13): - Home — landing for the actual app, quick links table, at-a-glance facts, repo layout tree. - Getting-Started — prerequisites incl. Bitwarden + jq + Firebase CLI, .env.local non-interactive unlock, secrets retrieval flow. - Build-and-Release — Gradle Play Publisher steady-state pattern, beta vs production track, signing setup, GitHub release notes format from CLI_RELEASE_GUIDE. - Architecture — module layout, MVVM, screen inventory (5 activities + 7 bottom sheets), end-to-end swipe-to-paid request flow, notifications worker. - Data-Model-and-Migrations — Firestore collections (legacy nested + new flat), document shapes, dual-write migration with the PaymentRepository helper, Phase 2-4 roadmap, failure modes. - Firebase-Setup — project IDs / app ID / GA4 IDs / Web OAuth client, google-services.json mechanics, Auth via Credential Manager, the 5 registered SHA-1 fingerprints, Firestore rules verbatim, Analytics link verification. - Design-System — theme stack, custom typography overrides, brand monochrome stance (why DynamicColors is disabled), semantic colour usage on the subscription list, grouped-list shape pattern, buttons / chips / motion / haptics / icons / edge-to-edge insets. - Analytics-and-Audit — full event taxonomy table (30+ events grouped by surface), what we never log, the audit recipe, DebugView smoke-test, cost (none). - Configuration-and-Versions — flattened version reference at v3.8-beta.8: AGP 9.0.1 / Kotlin 2.3.0 / Gradle 8.13 / SDK 35-36, Firebase BoM 32.7.2, Material 1.14.0-alpha08, etc. - Release-Timeline — chronological per-tag index (v1.0 through v3.8-beta.8) noting what each release shipped, missing v2.2 tag. - Troubleshooting — build/auth/Firestore/notifications/UI/release failure modes with the fix for each. - Known-Issues — current rough edges prioritised: catalog bypass, hardcoded Web Client ID, dead pause/delete paths in SubscriptionActionHelper, stale About sheet preview text, etc. - Contributing — branch strategy (main only), Conventional Commits, analytics discipline for new flows. Plus sidebar updated to the new page set; obsolete pages removed (Build-and-Run, Firebase-and-Google-Sign-In, Branding-and-Assets, Release-and-Versioning, Known-Issues-and-Caveats).

Aarsh committed May 24, 2026