Skip to content

flow-mn/flow

Repository files navigation

Flow logo Flow

Flow's GitHub repo  Join Flow Discord server Support on Ko-fi

Download Flow (beta)

Join Play Store Open Testing Join TestFlight group See Codemagic builds

Backuping up before updating is highly recommended!

Preface

Flow is a free, open-source, cross-platform personal finance tracking app.

Beta available on Android, iOS, and more1

Features

  • Multiple accounts
  • Multiple currencies
  • Fully-offline
  • Full export/backup
    • JSON for backup
    • CSV for external software use (i.e., Google Sheets)

Try Beta version

We've release Flow beta on March 6. You can download the beta builds for iOS and Android right now. Beta version features all the basic functionality for an expense tracker app. JSON backups from Alpha and Beta versions are guaranteed to be supported by the next major releases, until Production.

Feedbacks and ideas are greatly appreciated 🌟

See what's coming on Flow's next release

Supported platforms

  • Android
  • iOS
  • and more1

Development

Please read Contribuition guide before contributing.

Prerequisites

Other:

  • JDK 17 if you're gonna build for Android
  • XCode if you're gonna build for iOS/macOS
  • To run tests on your machine, see Testing

Building for Windows, and Linux-based systems requires the same dependencies as Flutter. Read more on https://docs.flutter.dev/platform-integration

Running

flutter run

See more on https://flutter.dev/

Testing

If you plan to run tests on your machine, ensure you've installed ObjectBox dynamic libraries.

Install ObjectBox dynamic libraries2:

bash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-dart/main/install.sh)

Testing:

flutter test

Footnotes

  1. Will be available on macOS, Windows, and Linux-based systems, but no plan to enhance the UI for desktop experience for now. 2

  2. Please double-check from the official website, may be outdated. Visit https://docs.objectbox.io/getting-started#add-objectbox-to-your-project (make sure to choose Flutter to see the script).