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