https://github.com/lyskouski/app-finance

Fingrom -- open-source platform-agnostic financial accounting application
https://github.com/lyskouski/app-finance

accounting budget-app budget-tracker finance-app finance-application finance-management finance-tracker flutter-app open-source

Last synced: about 1 month ago
JSON representation

Fingrom -- open-source platform-agnostic financial accounting application

• Host: GitHub
• URL: https://github.com/lyskouski/app-finance
• Owner: lyskouski
• License: other
• Created: 2023-06-15T07:22:58.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-24T14:10:33.000Z (3 months ago)
• Last Synced: 2025-03-31T06:09:10.018Z (about 2 months ago)
• Topics: accounting, budget-app, budget-tracker, finance-app, finance-application, finance-management, finance-tracker, flutter-app, open-source
• Language: Dart
• Homepage: https://tercad.com/app/finance/index.html
• Size: 1.36 GB
• Stars: 79
• Watchers: 2
• Forks: 16
• Open Issues: 23
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-open-source-flutter-applications - Finance App - finance) |  |  |  |  | (Flutter Project Showcase)
• awesome-open-source-flutter-applications - Finance App - finance) |  |  |  |  | (Flutter Project Showcase)

README

        
[ English | [Deutsch](./README_de.md) | [简体中文](./README_zh-CN.md) | [...](./assets/l10n/about_en.md) ]

# ![Fingrom Logo](./docs/design-flow/logo/main.svg) Financial Accounting Application

[![License: CC BY-NC-ND 4.0](https://img.shields.io/badge/License-CC_BY--NC--ND_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-nd/4.0/) 

[![Check Status](https://github.com/lyskouski/app-finance/actions/workflows/push_to_main.yml/badge.svg?branch=main)](https://github.com/lyskouski/app-finance/actions/workflows/push_to_main.yml)

[![Build Status](https://github.com/lyskouski/app-finance/actions/workflows/build.yml/badge.svg)](https://github.com/lyskouski/app-finance/actions/workflows/build.yml)

[![Unit Tests Coverage](https://lyskouski.github.io/app-finance/coverage/unit_coverage_badge.svg)](https://lyskouski.github.io/app-finance/coverage/unit/index.html)

[![Widget Tests Coverage](https://lyskouski.github.io/app-finance/coverage/widget_coverage_badge.svg)](https://lyskouski.github.io/app-finance/coverage/widget/index.html)

[![End-To-End Coverage](https://lyskouski.github.io/app-finance/coverage/e2e_coverage_badge.svg)](https://lyskouski.github.io/app-finance/coverage/e2e/index.html)

**Fingrom** -- open-source cross-platform financial accounting application without Ads and limitations.

The goal of the solution is to create a financial accounting application that is intuitive, efficient, and inclusive. 

That empowers users to effortlessly manage their finances while ensuring that no one is left behind.

[![Watch the video](./docs/marketing-flow/presentation_video.png)](https://youtu.be/sNTbpILLsOw)

| Type                     | Alpha Version         | Pre-Release                   | Release                       |

| ------------------------ | ----------------------| ----------------------------- | ----------------------------- |

| ![Apple](./docs/design-flow/icons/apple.png) iOS (Apple Store)        | [fingrom_iOS.ipa](https://github.com/lyskouski/app-finance/releases/latest) | [TestFlight: Fingrom](https://testflight.apple.com/join/93ECy9ZB) | [![iOS Apple Store](./docs/design-flow/badges/ios.png)](https://apps.apple.com/us/app/fingrom/id6463955600) |

| ![Apple](./docs/design-flow/icons/apple.png) macOS (Apple Store)      | [fingrom_macOS.zip](https://github.com/lyskouski/app-finance/releases/latest) | Not available for testing | [![macOS Apple Store](./docs/design-flow/badges/macos.png)](https://apps.apple.com/us/app/fingrom/id6463955600) |

| ![Android](./docs/design-flow/icons/android.png) Android (Google Play)    | [fingrom_Android.aab](https://github.com/lyskouski/app-finance/releases/latest) | [Google Play](https://play.google.com/store/apps/details?id=com.tercad.fingrom) | [![Google Play](./docs/design-flow/badges/google.png)](https://play.google.com/store/apps/details?id=com.tercad.fingrom) |

| ![Android](./docs/design-flow/icons/android.png) Android (Galaxy Store)   | [fingrom_Android.aab](https://github.com/lyskouski/app-finance/releases/latest) | [Galaxy Store](https://galaxystore.samsung.com/detail/com.tercad.fingrom) | [![Fingrom](./docs/design-flow/badges/galaxy-store.png)](https://galaxystore.samsung.com/detail/com.tercad.fingrom) |

| ![Android](./docs/design-flow/icons/android.png) Android (Huawei Gallery) | [fingrom_Android.aab](https://github.com/lyskouski/app-finance/releases/latest) | [App Gallery](https://appgallery.huawei.com/#/app/C109437079) | [![App Gallery](./docs/design-flow/badges/huawei.png)](https://appgallery.huawei.com/#/app/C109437079) |

| ![Android](./docs/design-flow/icons/android.png) Android (Amazon Appstore) | [fingrom_Android.aab](https://github.com/lyskouski/app-finance/releases/latest) | [Amazon Appstore](https://www.amazon.com/gp/product/B0DKFNJ45R) | [![Amazon Appstore](./docs/design-flow/badges/amazon.png)](https://www.amazon.com/gp/product/B0DKFNJ45R) |

| ![Linux](./docs/design-flow/icons/linux.png) Linux (Snap Store)       | [fingrom_LinuxSnap.snap](https://github.com/lyskouski/app-finance/releases/latest) | [![Fingrom](https://snapcraft.io/fingrom/badge.svg)](https://snapcraft.io/fingrom) | [![Snapcraft: Fingrom](./docs/design-flow/badges/snap-store.png)](https://snapcraft.io/fingrom) |

| ![Linux](./docs/design-flow/icons/linux.png) Linux (Flathub)          | [fingrom_LinuxFlatpak.flatpak](https://github.com/lyskouski/app-finance/releases/latest)  | Not available | [ ![Flathub: Fingrom](./docs/design-flow/badges/flathub.png) ](https://flathub.org/apps/com.tercad.fingrom) |

| ![Linux](./docs/design-flow/icons/linux.png) Linux (AppImage)         | [fingrom_Linux.AppImage](https://github.com/lyskouski/app-finance/releases/latest) | [Pling Store](https://www.pling.com/p/2173504/) | [![App Image Hub](./docs/design-flow/badges/appimagehub.png)](https://www.appimagehub.com/p/2173504) |

| ![Windows](./docs/design-flow/icons/windows.png) Windows (Partner Center) | [fingrom_Windows.zip](https://github.com/lyskouski/app-finance/releases/latest) | [App Center: Fingrom](https://appcenter.ms/orgs/terCAD/apps/Fingrom) | [![Microsoft Store](./docs/design-flow/badges/windows.png)](https://apps.microsoft.com/detail/fingrom/9NNPDJ2ST0HV) |

| ![Web Browsers](./docs/design-flow/icons/web.png) Web                      | [fingrom_Web.tar.gz](https://github.com/lyskouski/app-finance/releases/latest) | [GitHub Pages: Fingrom](https://lyskouski.github.io/app-finance/) | [terCAD: Fingrom](https://tercad.com/app/finance/index.html) |

## Functionality

- Accounting (Account Type, Currency/Cryptocurrency)

  - Simple grouping via `/`-symbol (in name) for the main page

  - Transactions log

  - Freeze amount by Update date (to import previous history)

- Budget Categories

  - Simple grouping via `/`-symbol (in name) for the main page

  - With limits restate:

    - Renewed at the beginning of each month

    - Configurable limits per month

    - Relatives (0.0 ... 1.0) to Income

  - Or, without limitations by showing a spent amount

  - Different timeline: weekly, monthly, yearly

  - Customizable start day of the week and month

- Bills, Transfers, Incomes (Invoices)

  - Recurring Payments (with a home widget for Android)

- Goals Definition

- Exchange rates, Default Currency for Summary

- Metrics: 

  - Budget:

    - Forecast (with Monte Carlo simulation)

    - Budget limit and expenses per month

  - Account:

    - Candlestick (OHLC) Chart

    - Income Health Radar

    - Currency Distribution

  - Bills:

    - YTD Expenses

    - Bar Race for Categories

  - Goals Gauge Chart

  - Currency Historical Chart

- [[demo]](https://youtu.be/RccQ8JpfJs4) Synchronization between devices (P2P) 

- Recovery via WebDav or a direct File

- Import from `CSV`, `QIF`, `OFX` files for Bills and Invoices

- Export to Excel `XLSX` file

- Data encryption

- Localization

- User Experience

  - Configurable Main Page (multiple configurations per `width x height` set)

  - Responsive & Adaptive Design

    - Adaptive navigation panel (top, bottom, right) and tabs (top, left)

  - Theme Mode (dark, light, system) with Palette definition (system, custom, personal -- colors selector)

  - Preserve last choice for Account, Budget, and Currency

  - Auto-scroll to the focused element on Form

  - Expand / Collapse sections on Main Page

  - Swipe for a quick access to Edit and Delete actions

  - Zoom in/out (from 60% up to 200%) via "Settings"

  - Shortcuts

| Description                         | Shortcut                       |

| ----------------------------------- | ------------------------------ |

| Open / Close the Navigation Drawer  | `Shift` + `Enter`              |

| Navigate Up                         | `up`                           |

| Navigate Down                       | `down`                         |

| Open Selected                       | `Enter`                        |

| Zoom In                             | `Ctrl` + `+`                   |

| Zoom In (with mouse)                | `Ctrl` + `scroll down`         |

| Zoom Out                            | `Ctrl` + `-`                   |

| Zoom Out (with mouse)               | `Ctrl` + `scroll up`           |

| Reset Zoom                          | `Ctrl` + `0`                   |

| Add new Transaction                 | `Ctrl` + `N`                   |

| Return Back                         | `Ctrl` + `Backspace`           |

## Support (Sponsorship)

As an open-source project, subscribing will not unlock any additional features in the app. However, it would serve as 

an investment in the continuous evolution and improvement of the application. So, if you'd like to contribute 

financially towards the efforts, please consider these options:

* [Github Sponsorship](https://github.com/users/lyskouski/sponsorship)

* [Paypal](https://www.paypal.me/terCAD)

* [Patreon](https://www.patreon.com/terCAD)

* [Donorbox](https://donorbox.org/tercad)

Or, [buy a :coffee:](https://www.buymeacoffee.com/lyskouski).

## Contributions

Any made contribution **is greatly appreciated** (also, by mentioning in `Contributors` section, `Release` notes, and 

in the app `About` - `Contributors` as a gratitude), check [Contribution Section](./CONTRIBUTING.md) for more details.

However, if it's been chosen a contribution (not just typo corrections) to this repo, you agree that you're giving

me a non-exclusive license to use that content, as I (and my possible team) deem appropriate. You probably guessed 

that already, but I just wanted to be extra clear on that.

## License & Copyright

The content herein are all © 2023 **terCAD** Team (Viachaslau Lyskouski).


This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 4.0 Unported License:

- **Attribution**: provide a link to the license, and indicate if changes were made

- **NonCommercial**: cannot be used as a part of a commercial solution

- **NoDerivatives**: any modification (remix, transform, or build upon the material) cannot be distributed by your own. 

  Push it back to the main repository (https://github.com/lyskouski/app-finance) to unblock the distribution for made 

  changes.