AccountingV2

AccountingV2 A personal finance and household budgeting app for Android, built on Dave Ramsey's envelope budgeting and debt snowball methodologies. Offline-first with Supabase cloud sync. Features Envelope budgeting — Allocate monthly income across spending categories; track spend vs. budget in real time Transactions — Log spending against envelopes, grouped by budget period Debt snowball — Add debts, log payments, simulate payoff timeline with minimum payment rollover Meter readings — Track electricity, water, and vehicle odometer consumption; anomaly detection flags readings >20% outside the 3-month rolling average Ramsey Score — 0–100 gamification score across logging consistency, envelope discipline, meter tracking, and Baby Steps progress Multi-household — Create multiple households, invite members via 6-character codes, switch between households Notifications — Daily logging reminders, monthly meter prompts, payday pre-flight envelope reminder Offline-first — All writes go to local SQLite immediately; synced to Supabase when online Tech Stack Layer Technology Framework Expo SDK 55 (Android only) Language TypeScript 5.9 (strict mode) UI React Native 0.83 + React Native Paper 5 + React Navigation 7 Local DB Expo SQLite + Drizzle ORM 0.45 Cloud Supabase (auth + PostgreSQL sync) State Zustand 5 Notifications expo-notifications + Firebase Cloud Messaging Testing Jest 30 + jest-expo + @testing-library/react-native Getting Started Prerequisites Node.js 20+ Android SDK with an AVD (Pixel 9 recommended) or a connected Android device A Supabase project Environment Copy .env.example to .env and fill in your Supabase credentials: cp .env.example .env EXPO_PUBLIC_SUPABASE_URL=https://.supabase.co EXPO_PUBLIC_SUPABASE_ANON_KEY= Install and run npm install npx expo run:android Project Structure src/ ├── domain/ # Pure business logic — no framework imports │ ├── budgets/ │ ├── debtSnowball/ │ ├── envelopes/ │ ├── households/ │ ├── meterReadings/ │ ├── scoring/ │ ├── transactions/ │ └── shared/ # Result, DomainError, BudgetPeriodEngine, Command interface │ ├── data/ # Data access │ ├── local/ # SQLite via Drizzle (schema/, migrations/) │ ├── remote/ # Supabase client + auth service │ ├── sync/ # SyncOrchestrator, RestoreService, PendingSyncEnqueuer │ └── audit/ # Immutable audit log for every domain write │ ├── infrastructure/ # Platform services │ ├── notifications/ │ ├── network/ # NetworkObserver — triggers sync on reconnect │ └── storage/ # expo-secure-store │ └── presentation/ # React Native UI ├── screens/ # auth/, budgets/, envelopes/, transactions/, │ # debtSnowball/, meters/, household/, settings/ ├── components/ ├── navigation/ # RootNavigator (tab-based) ├── stores/ # Zustand (session, household, sync status, budget period) └── theme/ # React Native Paper theme (Teal #00695C), tokens, fonts Architecture Strict Clean Architecture dependency direction: Domain → Data → Infrastructure → Presentation Domain — Pure TypeScript use cases and entities. Each use case implements Command and returns Result (never throws). Zero React, Expo, or I/O dependencies. Data — Drizzle ORM for local SQLite. PendingSyncEnqueuer queues every write. SyncOrchestrator pushes the queue to Supabase when online. RestoreService pulls remote state on login. Infrastructure — Network state, local notifications, secure storage, crypto. Presentation — Screens consume use cases directly. Zustand tracks global session state.