Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/flow-mn/flow

A personal finance tracker app built with love, and Flutter
https://github.com/flow-mn/flow

dart dartlang expense expense-manager expense-tracker finance flutter foss free money mongolia open-source personal-f

Last synced: 29 days ago
JSON representation

A personal finance tracker app built with love, and Flutter

Awesome Lists containing this project

README

        

# ![Flow logo]([email protected]) Flow

[![Flow's GitHub repo](https://img.shields.io/badge/GitHub-flow--mn/flow-f5ccff?logo=github&logoColor=white&style=for-the-badge)](https://github.com/flow-mn/flow) 
[![Join Flow Discord server](https://img.shields.io/badge/Discord-Flow-f5ccff?logo=discord&logoColor=white&style=for-the-badge)](https://discord.gg/Ndh9VDeZa4)
[![Support on Ko-fi](https://img.shields.io/badge/kofi-sadespresso-f5ccff?logo=ko-fi&logoColor=white&style=for-the-badge&label=Ko-fi)](https://ko-fi.com/sadespresso)

## Download Flow (beta)

[![Join Play Store Open Testing](https://img.shields.io/badge/Google_Play-open_testing-f5ccff?logo=google-play&logoColor=white&style=for-the-badge)](https://play.google.com/store/apps/details?id=mn.flow.flow)
[![Join TestFlight group](https://img.shields.io/badge/TestFlight-beta_testing-f5ccff?logo=appstore&logoColor=white&style=for-the-badge)](https://testflight.apple.com/join/NH4ifijS)
[![See Codemagic builds](https://img.shields.io/badge/CodeMagic-see_builds-f5ccff?logo=codemagic&logoColor=white&style=for-the-badge)](https://codemagic.io/apps/65950ed30591c25df05b5613/65950ed30591c25df05b5612/latest_build)

> 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 more[^1]

### 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](#download-flow-beta) 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](https://github.com/flow-mn/flow/milestone/2)

## Supported platforms

* Android
* iOS
* and more[^1]

## Development

Please read [Contribuition guide](./CONTRIBUTING.md) before contributing.

### Prerequisites

* [Flutter](https://flutter.dev/) (stable)

Other:

* JDK 17 if you're gonna build for Android
* [XCode](https://developer.apple.com/xcode/) if you're gonna build for iOS/macOS
* To run tests on your machine, see [Testing](#testing)

Building for Windows, and Linux-based systems requires the same dependencies
as Flutter. Read more on

### Running

`flutter run`

See more on

### Testing

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

Install ObjectBox dynamic libraries[^2]:

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

Testing:

`flutter test`

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

[^2]: Please double-check from the official website, may be outdated. Visit

(make sure to choose Flutter to see the script).