Skip to content

j-ordanos/Flo

Flo Icon

Personal finance, simplified.

Track expenses, set budgets, and understand your Spendings — offline-first with optional cloud sync.

Flutter Dart Supabase Platform

⬇ Download APK  ·  Report a Bug


Demo


Screen recording of the app in action

Screenshots

Dashboard   Analytics   Budgets   Profile

Features

Expense & Income Logging — amount keypad, category, date, and optional notes Dashboard — monthly expenses, income, balance, and budget status at a glance Category Budgets — set monthly limits, track remaining budget, and get overage alerts Analytics — bar charts and category breakdowns by day, week, or month Receipt Capture — attach receipt photos to transactions (requires Supabase) CSV Export — export and share reports via the system share sheet Push Notifications — local alerts for budget overages Offline-First — all data is stored locally; Supabase is optional Cloud Sync — sign in to sync across devices with safe conflict resolution


Tech Stack

Layer Technology
Framework Flutter + Dart
State management Riverpod
Navigation GoRouter
Local database Drift / SQLite
Cloud Supabase (Auth, Postgres, Storage)
Charts fl_chart
Notifications flutter_local_notifications

Getting Started

1 — Install dependencies

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

2 — Run (local-only, no account needed)

flutter run

3 — Run with Supabase (accounts + cloud sync)

cp env/example.json env/dev.json
# Open env/dev.json and fill in your Supabase URL and anon key
flutter run --dart-define-from-file=env/dev.json

4 — Build a release APK

bash scripts/build_apk.sh
# Output: build/app/outputs/flutter-apk/app-release.apk

Supabase — database migrations

Create a Supabase project, open the SQL editor, and run each file in supabase/migrations/ in order:

  1. 0001_initial_schema.sql
  2. 0002_receipts.sql
  3. 0003_transaction_type.sql
  4. 0004_category_kind.sql

About

A local-first personal finance Flutter app for tracking expenses, income, budgets, and spending trends — with optional Supabase cloud sync.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors