SceneSplit

Split group expenses, track who owes what, and settle up — fully offline.

SceneSplit is a Flutter expense-splitting app for trips, roommates, dinners, and events. No account, no cloud — everything stays on your device.

Try the live demo

Download

Get SceneSplit from Google Play, or download the latest builds for all supported platforms from GitHub Releases.

Screenshots

Home (light)	Home (dark)
Group detail	Pending summary

Features

• People & groups — Manage a global people pool from Profile; create groups with emoji icons and members
• Flexible splits — Equal, exact amounts, or percentage, with live validation; choose who is included per expense
• Balances & settlements — Live balances across groups, smart settlement suggestions, and editable settlement records
• Insights — Group expense total and member-share pie chart on group detail
• Currency — App-wide default for home summary and new groups; each group has its own currency
• Appearance — System, light, or dark theme (saved and applied before first frame)
• Backup — Export and import a local database backup (non-web platforms)
• Legal & about — In-app privacy policy, terms of service, and app version
• Offline-first — All data stored locally with Drift (SQLite); no sign-in required

Tech Stack

Layer	Technology
Framework	Flutter 3.44 / Dart 3.12
State management	Riverpod 3
Database	Drift 2.34 (SQLite)
Architecture	Feature-first + service / repository
Charts	fl_chart
Navigation	Material navigation (go_router listed for future use)

Prerequisites

• Flutter SDK (3.44.5 stable or compatible)
• Dart SDK ^3.12.2

Getting Started

flutter pub get
dart run build_runner build --delete-conflicting-outputs   # only after schema changes
flutter run

Project Structure

lib/
├── main.dart / app.dart
├── core/
│   ├── constants/     # currencies, group emojis, assets
│   ├── theme/
│   └── utils/         # money formatting
├── database/
│   ├── tables.dart
│   ├── app_database.dart
│   └── app_database.g.dart
├── repositories/      # user, group, expense, settlement
├── services/          # split engine, balance
├── providers/         # Riverpod streams and derived state
├── features/
│   ├── onboarding/
│   ├── home/
│   ├── groups/        # create, edit, detail
│   ├── expenses/
│   ├── settlements/
│   ├── profile/       # appearance, currency, people, data & backup
│   ├── legal/
│   └── about/
└── shared/widgets/

Database Schema

All money amounts are stored as integer cents.

Table	Purpose
Users	Global people pool (id, name, colorIndex, isCurrentUser)
AppSettings	Single row: default currencyCode, themeMode
Groups	Group name, emoji, currencyCode
GroupMembers	Group ↔ user membership
Expenses	Group expenses (amountCents, paidById, splitType, note, date)
ExpenseSplits	Per-user split amounts
Settlements	Recorded payments between members

Commands

flutter pub get
flutter analyze
flutter test
dart run build_runner build --delete-conflicting-outputs
flutter run

See AGENTS.md for dependency pins, architecture conventions, and codegen notes.

Future Enhancements

• Backend sync
• Multi-currency with exchange rates
• Receipt scanning
• Export (PDF / CSV)
• Localization

Contributing

CI, PR checks, releasing, and GitHub secrets are documented in CONTRIBUTING.md.

License

MIT