How ragav1n/novira works
Novira is a personal and shared-expense finance app. The main workflow is entering an expense, recording it as a transaction, and syncing it to Supabase; when offline, queued changes retry later. The product also supports shared groups and trips, budgeting and goals, recurring payments, analytics and recaps, imports/exports, and notifications. Some feature implementations were not sampled, so those branches reflect README descriptions and the file tree; edges without direct source evidence are documented or marked unverified.
Main entry points: sync-manager.ts Sync manager · transaction-service.ts Transaction service · supabase.ts Supabase data services · dashboard-view.tsx Dashboard
Components 22
Expense management
- Add expense
components/add-expense-view.tsx - Transaction service
lib/services/transaction-service.ts - Dashboard
components/dashboard-view.tsx - Groups and splits
components/groups-view.tsx - Trip expenses
components/trips - Subscriptions
components/subscriptions-view.tsx - Statement import
components/import-view.tsx
Persistence and sync
- Receipt storage
lib/receipt-storage.ts - Offline queue
lib/offline-sync-queue.ts - Sync manager
lib/sync-manager.ts - User preferences
components/providers/user-preferences-provider.tsx - Supabase data services
lib/supabase.ts
Planning and insights
- Analytics
components/analytics-view.tsx - Goals and buckets
components/goals-view.tsx - Cash flow
app/cashflow - Monthly recap
lib/recap-generator.ts - Report export
utils/export-utils.ts
Identity and notifications
- Authentication
utils/supabase/server.ts - Push notifications
lib/server/push.ts - Scheduled digests
app/api/cron
Other components
- User
- Supabase service
Connections 22
- User → Add expense: enters expense
README.md - Add expense → Transaction service: submits transaction
- Transaction service → Offline queue: queues mutations
lib/services/transaction-service.ts - Transaction service → Supabase data services: reads transactions
lib/services/transaction-service.ts - Sync manager → Offline queue: processes queue
lib/sync-manager.ts - Sync manager → Receipt storage: uploads receipts
lib/sync-manager.ts - User preferences → Sync manager: starts sync
components/providers/user-preferences-provider.tsx - Dashboard → Supabase data services: loads transactions
- Dashboard → Sync manager: reads pending changes
- User → Groups and splits: splits shared costs
README.md - User → Trip expenses: tracks trip spending
README.md - User → Subscriptions: tracks recurring bills
README.md - User → Statement import: imports statements
README.md - User → Analytics: reviews spending
README.md - User → Goals and buckets: sets savings targets
README.md - User → Cash flow: checks projections
README.md - User → Monthly recap: requests recap
README.md - User → Report export: exports reports
README.md - User → Authentication: signs in
- Authentication → Supabase data services: creates server client
utils/supabase/server.ts - Scheduled digests → Push notifications: sends digests
app/api/cron/daily-digest/route.ts - Scheduled digests → Supabase service: queries user data
app/api/cron/daily-digest/route.ts