How sr7911/splitex works
SplitEx is a Flutter expense-management app for shared room expenses and personal finance. A user signs in, navigates the app, then records shared or personal transactions; providers expose app state while services handle Firebase-backed operations. Room capabilities include splitting, bills, settlements, activity, analytics, and notifications; personal finance includes budgets, recurring transactions, and peer debts. The README documents these capabilities and the broad architecture, but Dart source was not sampled, so links between individual screens, providers, and services are documented at subsystem level. Loan management is marked planned and is omitted.
Main entry points: expense_service.dart Firebase services · home_screen.dart Home dashboard · personal_expense_provider.dart Personal finance state · room_provider.dart Room and group state
Components 21
App shell
- Flutter entry
lib/main.dart - Navigation and theme
lib/config/router.dart - Sign-in screens
lib/screens/auth/login_screen.dart - Authentication state
lib/providers/auth_provider.dart - Home dashboard
lib/screens/home/home_screen.dart
Shared expenses
- Room expense screens
lib/screens/room/room_detail_screen.dart - Group expense screens
lib/screens/groups/group_dashboard_screen.dart - Room and group state
lib/providers/room_provider.dart - Settlement screens
lib/screens/settlement/settlement_screen.dart - Analytics screens
lib/screens/analytics/analytics_screen.dart - Activity log
lib/screens/activity/activity_screen.dart
Personal finance
- Personal finance screens
lib/screens/personal/personal_expense_tab.dart - Personal finance state
lib/providers/personal_expense_provider.dart - Recurring processor
lib/services/recurring_processor.dart
Services and data
- Push notifications
lib/services/fcm_service.dart - Firebase services
lib/services/expense_service.dart - Finance data models
lib/models/expense_model.dart - Firestore
- Firebase Auth
Other components
- User
- UPI payment apps
Connections 22
- User → Flutter entry: opens app
README.md - Flutter entry → Navigation and theme: starts navigation
README.md - User → Sign-in screens: signs in
README.md - Sign-in screens → Authentication state: uses auth state
README.md - Authentication state → Firebase Auth: authenticates
README.md - User → Home dashboard: views dashboard
README.md - Home dashboard → Room expense screens: opens shared expenses
README.md - Home dashboard → Personal finance screens: opens personal finance
README.md - Room expense screens → Room and group state: uses room state
README.md - Group expense screens → Room and group state: uses group state
README.md - Room and group state → Firebase services: uses services
README.md - Personal finance screens → Personal finance state: uses finance state
README.md - Personal finance state → Firebase services: uses services
README.md - Firebase services → Firestore: reads and writes
README.md - Firebase services → Finance data models: serializes records
README.md - User → Settlement screens: settles balances
README.md - Settlement screens → UPI payment apps: opens payment app
README.md - User → Analytics screens: views charts
README.md - User → Activity log: reviews activity
README.md - User → Push notifications: receives alerts
README.md - Personal finance state → Recurring processor: processes recurring
README.md - Recurring processor → Firebase services: stores transactions