History / Getting Started

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

docs: comprehensive human-facing wiki Replaces the placeholder Home with a full set of pages targeted at humans (devs, contributors, release engineers). The main repository is the agent contract (AGENTS.md); everything narrative now lives here. Pages: - Home — landing, quick links, at-a-glance facts, repo layout. - Getting-Started — prerequisites, clone, open in Studio, first run. - Build-and-Run — gradle tasks, outputs, signing, AAB. - Architecture — module/runtime layout, auth flow diagram, theme, backup rules, dependency rationale. - Firebase-and-Google-Sign-In — the Firebase project that ships with the repo, the OAuth flow on the wire, how to repoint at your own project, SHA-1 fingerprint management, Credential Manager migration direction. - Branding-and-Assets — display name, package, icons, theme, backup/data-extraction rules. - Configuration-and-Versions — every version pin (Gradle, AGP, Kotlin, SDKs, deps) and where to change each. - Release-and-Versioning — master vs main branch histories, v1.0-v3.4 tag timeline, versionCode/versionName workflow, release checklist, hotfix flow. - Troubleshooting — common build & runtime failures with the actual fix in each case. - Known-Issues-and-Caveats — leftover HelloWorld names, deprecated GoogleSignIn API, test-package mismatch, etc. - Contributing — branches, issue/PR style, Conventional Commits, code style. - _Sidebar / _Footer — wiki navigation.

Aarsh committed May 24, 2026