Merge pull request #301 from flow-mn:develop

Release 0.11.1

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## Beta 0.11.1
+
+### Fixes
+
+* [IMPORTANT] Fixed Stats tab first day of month (or any range) was missing
+This led to incorrect avg. daily expense/income, which, now, is fixed.
+
+### New fetures
+
+* Now you can use OLED themes, closes [#288](https://github.com/flow-mn/flow/issues/288)
+* Now you can sync your balance at an exact date, closes [#293](https://github.com/flow-mn/flow/issues/293)
+
 ## Beta 0.11.0
 
 * Reworked stats tab (ongoing)

CONTRIBUTING.md

@@ -3,21 +3,19 @@
 Thank you for stopping by here! There are many ways to make Flow better for
 everyone. Here are few:
 
-* [Reporting a bug](https://github.com/flow-mn/flow/issues/new/choose)
-* [Proposing a feature](https://github.com/flow-mn/flow/issues/new?assignees=&labels=&projects=&template=feature_request.yaml&title=%5BFEAT%5D+)
-* Submitting [fixes, feature implementations](#developing)
+* [Report a bug](https://github.com/flow-mn/flow/issues/new/choose)
+* [Propos a feature](https://github.com/flow-mn/flow/issues/new?assignees=&labels=&projects=&template=feature_request.yaml&title=%5BFEAT%5D+)
+* [Contribute code](#developing)
 * [Translating Flow](#translating) to your own language
-* [Tipping the maintainer](https://buymeacoffee.com/sadespresso). Flow is a
-free and open-source software, and will stay this way. Please understand
-that by giving tip, you will NOT unlock any new or additional features.
-As of now, publishing fees have been paid by the maintainer.
+* [Buy maintainer a coffee](https://buymeacoffee.com/sadespresso). Flow is a
+free and open-source software, and will stay this way.
 
 ## Developing
 
 NOTE: A quick discussion upfront can highlight any potential issues, streamline
 the merge process, and ensure you're on the right track to avoid rework.
 
-TIP: Look for issues with `ready` label to get contributing immediately
+TIP: Look for issues with `ready` label to get started without any friction
 
 1. Fork the repository
 2. Pick an issue. If the fix/feature you're gonna work doesn't have an issue,
@@ -39,6 +37,8 @@ implementing a new feature
 * Any new dependency must support the all the platforms except for Web
 * It is not necessary to change the version unless you're in charge of
 publishing a release
+* Update [CHANGELOG.md](./CHANGELOG.md) with your change description. (Use
+version name `Next`)
 
 ## Translating
 

README.md

@@ -5,80 +5,88 @@
 [![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)
 
-## Download Flow (beta)
+## Preface
 
-[![Google Play Store](https://img.shields.io/badge/Google_Play_Store-beta-f5ccff?logo=google-play&logoColor=white&style=for-the-badge)](https://play.google.com/store/apps/details?id=mn.flow.flow)
-[![App Store](https://img.shields.io/badge/App_Store-beta-f5ccff?logo=appstore&logoColor=white&style=for-the-badge)](https://apps.apple.com/mn/app/flow-expense-tracker/id6477741670)
-[![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)
+![Flow logo]([email protected]) Flow is a
 
-> Backuping up before updating is highly recommended!
+* Free
+* Open-Source
+* Simple
+* UX-Focused
+* Fully-offline[^1]
+* Cross-platform[^2]
 
-## Preface
+personal expense tracking app.
 
-Flow is a free, open-source, cross-platform personal finance tracking app.
+## Download Flow (beta)
 
-Beta available on Android, iOS, and more[^1]
+[![Google Play Store](https://img.shields.io/badge/Google_Play_Store-beta-f5ccff?logo=google-play&logoColor=white&style=for-the-badge)](https://play.google.com/store/apps/details?id=mn.flow.flow)
+[![App Store](https://img.shields.io/badge/App_Store-beta-f5ccff?logo=appstore&logoColor=white&style=for-the-badge)](https://apps.apple.com/mn/app/flow-expense-tracker/id6477741670)
+[![Other build files](https://img.shields.io/badge/releases-other_build_files-f5ccff?logo=github&logoColor=white&style=for-the-badge)](https://github.com/flow-mn/flow/releases/latest)
 
-### Features
+> You can build and run for Linux and macOS. Haven't tested Windows yet[^2]
 
+## Features
+
+* Simple & seamless UX
 * Multiple accounts
 * Multiple currencies
-* Fully-offline
+* Fully-offline[^1]
 * Full export/backup
-  * JSON for backup
-  * CSV for external software use (i.e., Google Sheets)
-
-## Try Flow
+  * Fully recoverable backups (ZIP/JSON)
+  * Export CSV for external software use (i.e., Google Sheets)
 
-Feedbacks and ideas are greatly appreciated 🌟
+## Support Flow
 
-Flow in production: [Blog post](https://blog.gege.mn/publishing-flow-to-production-20250104?showSharer=true)
+Flow is a personal project developed during my free time, and it generates no
+income. Consider helping Flow! Here are some suggestions:
 
-## Supported platforms
-
-* Android
-* iOS
-* and more[^1]
+* Give a star on [GitHub](https://github.com/flow-mn/flow)
+* Leave a review on [Google Play](https://play.google.com/store/apps/details?id=mn.flow.flow) and [App Store](https://apps.apple.com/mn/app/flow-expense-tracker/id6477741670)
+* Tell a friend
+* [Buy me a coffee](https://buymeacoffee.com/sadespresso)
+
+  Maintaining Flow on the App Store requires a substantial annual fee
+  (see [Apple Developer Program](https://developer.apple.com/support/enrollment/#:~:text=The%20Apple%20Developer%20Program%20annual,in%20local%20currency%20where%20available.)),
+  which [I currently cover](https://github.com/sadespresso).  To ensure Flow's
+  continued existence and future development, your support is greatly appreciated.
 
 ## Development
 
 Please read [Contribuition guide](./CONTRIBUTING.md) before contributing.
 
 ### Prerequisites
 
-* [Flutter](https://flutter.dev/) (stable)
+* [Flutter](https://flutter.dev/) (latest stable)
 
 Other:
 
-* JDK 17 if you're gonna build for Android
+* JDK 1.8 or 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 <https://docs.flutter.dev/platform-integration>
-
-### Running
-
-`flutter run`
-
-See more on <https://flutter.dev/>
+Building for Windows, macOS, and Linux-based systems requires the same
+dependencies as Flutter. Read more on <https://docs.flutter.dev/platform-integration>
 
 ### Testing
 
 If you plan to run tests on your machine, ensure you've installed ObjectBox
 dynamic libraries.
 
-Install ObjectBox dynamic libraries[^2]:
+Install ObjectBox dynamic libraries[^3]:
 
 `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
+[^1]: Flow requires internet to download currency exchage rates. Only necessary
+if you use more than one currencies
+
+[^2]: 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
+[^3]: 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).

assets/l10n/en_IN.json

@@ -86,6 +86,10 @@
     "account.excludeFromTotalBalance.description": "If you check this option, this account's balance will not be included in the total balance. Useful for savings or non-personal accounts.",
     "account.updateBalance": "Update balance",
     "account.updateBalance.transactionTitle": "Update balance",
+    "account.updateBalance.chooseUpdateMode": "Choose update mode",
+    "account.updateBalance.updateCurrent": "Update current balance",
+    "account.updateBalance.updateAtDate": "Sync past balance by date",
+    "account.updateBalance.updateAtDate.description": "Ideal if you know the exact balance on a specific date",
     "account.new": "Add an account",
     "account.edit": "Edit account",
     "account.edit.selectCurrency": "Select a currency",
@@ -148,6 +152,7 @@
     "transactions.query.filter.categories.all": "All Categories",
     "transactions.query.filter.groupBy": "Group by",
     "transactions.query.filter.sort": "Sort",
+    "transactions.query.filter.currency": "Currency",
     "transactions.count": "{} transactions",
 
     "category": "Category",
@@ -176,6 +181,7 @@
     "preferences.theme.other": "Other themes",
     "preferences.theme.themeChangesAppIcon": "App icon follows theme",
     "preferences.theme.enableDynamicTheme": "Dynamic theme",
+    "preferences.theme.enableOledTheme": "Use OLED theme",
     "preferences.numpad": "Numpad",
     "preferences.numpad.layout": "Numpad layout",
     "preferences.numpad.layout.classic": "Classic",
@@ -266,6 +272,11 @@
 
     "support": "Support",
     "support.description": "Flow is a labor of love, built free, and open for all. If you find Flow valuable, consider helping the project grow! Here are some ways to do so:",
+    "support.leaveAReview": "Leave a review",
+    "support.leaveAReview.description": "You can rate Flow and leave a review on {appStore}",
+    "support.leaveAReview.action": "Rate Flow",
+    "support.starOnGitHub": "Star on GitHub",
+    "support.starOnGitHub.description": "Starring Flow on GitHub helps people discover Flow",
     "support.requestFeatures": "Give us ideas",
     "support.requestFeatures.description": "You can also support us by giving feedback, and suggestion ideas to make Flow better.",
     "support.requestFeatures.action": "Visit issue tracker",
@@ -331,6 +342,7 @@
     "enum.TransactionSubtype@transactionFee": "Transaction fee",
     "enum.TransactionSubtype@givenLoan": "Loan (given)",
     "enum.TransactionSubtype@receivedLoan": "Loan (taken)",
+    "enum.TransactionSubtype@updateBalance": "Update balance",
     "enum.TransactionType": "Transaction type",
     "enum.TransactionType@income": "Income",
     "enum.TransactionType@expense": "Expense",

assets/l10n/en_US.json

@@ -86,6 +86,10 @@
     "account.excludeFromTotalBalance.description": "If you check this option, this account's balance will not be included in the total balance. Useful for savings or non-personal accounts.",
     "account.updateBalance": "Update balance",
     "account.updateBalance.transactionTitle": "Update balance",
+    "account.updateBalance.chooseUpdateMode": "Choose update mode",
+    "account.updateBalance.updateCurrent": "Update current balance",
+    "account.updateBalance.updateAtDate": "Sync past balance by date",
+    "account.updateBalance.updateAtDate.description": "Ideal if you know the exact balance on a specific date",
     "account.new": "Add an account",
     "account.edit": "Edit account",
     "account.edit.selectCurrency": "Select a currency",
@@ -148,6 +152,7 @@
     "transactions.query.filter.categories.all": "All Categories",
     "transactions.query.filter.groupBy": "Group by",
     "transactions.query.filter.sort": "Sort",
+    "transactions.query.filter.currency": "Currency",
     "transactions.count": "{} transactions",
 
     "category": "Category",
@@ -176,6 +181,7 @@
     "preferences.theme.other": "Other themes",
     "preferences.theme.themeChangesAppIcon": "App icon follows theme",
     "preferences.theme.enableDynamicTheme": "Dynamic theme",
+    "preferences.theme.enableOledTheme": "Use OLED theme",
     "preferences.numpad": "Numpad",
     "preferences.numpad.layout": "Numpad layout",
     "preferences.numpad.layout.classic": "Classic",
@@ -266,6 +272,11 @@
 
     "support": "Support",
     "support.description": "Flow is a labor of love, built free, and open for all. If you find Flow valuable, consider helping the project grow! Here are some ways to do so:",
+    "support.leaveAReview": "Leave a review",
+    "support.leaveAReview.description": "You can rate Flow and leave a review on {appStore}",
+    "support.leaveAReview.action": "Rate Flow",
+    "support.starOnGitHub": "Star on GitHub",
+    "support.starOnGitHub.description": "Starring Flow on GitHub helps people discover Flow",
     "support.requestFeatures": "Give us ideas",
     "support.requestFeatures.description": "You can also support us by giving feedback, and suggestion ideas to make Flow better.",
     "support.requestFeatures.action": "Visit issue tracker",
@@ -331,6 +342,7 @@
     "enum.TransactionSubtype@transactionFee": "Transaction fee",
     "enum.TransactionSubtype@givenLoan": "Loan (given)",
     "enum.TransactionSubtype@receivedLoan": "Loan (taken)",
+    "enum.TransactionSubtype@updateBalance": "Update balance",
     "enum.TransactionType": "Transaction type",
     "enum.TransactionType@income": "Income",
     "enum.TransactionType@expense": "Expense",

assets/l10n/it_IT.json

@@ -86,6 +86,10 @@
     "account.excludeFromTotalBalance.description": "Se selezioni questa opzione, il saldo di questo conto non sarà incluso nel saldo totale. Utile per risparmi o conti non personali.",
     "account.updateBalance": "Aggiorna saldo",
     "account.updateBalance.transactionTitle": "Aggiorna saldo",
+    "account.updateBalance.chooseUpdateMode": "Scegli la modalità di aggiornamento",
+    "account.updateBalance.updateCurrent": "Aggiorna saldo corrente",
+    "account.updateBalance.updateAtDate": "Sincronizza saldo passato per data",
+    "account.updateBalance.updateAtDate.description": "Ideale se conosci il saldo esatto in una data specifica",
     "account.new": "Aggiungi un conto",
     "account.edit": "Modifica conto",
     "account.edit.selectCurrency": "Seleziona una valuta",
@@ -148,6 +152,7 @@
     "transactions.query.filter.categories.all": "Tutte le categorie",
     "transactions.query.filter.groupBy": "Raggruppa per",
     "transactions.query.filter.sort": "Ordina",
+    "transactions.query.filter.currency": "Valuta",
     "transactions.count": "{count} transazioni",
 
     "category": "Categoria",
@@ -176,6 +181,7 @@
     "preferences.theme.other": "Altri temi",
     "preferences.theme.themeChangesAppIcon": "Icona dell'app segue il tema",
     "preferences.theme.enableDynamicTheme": "Tema dinamico",
+    "preferences.theme.enableOledTheme": "Usa tema OLED",
     "preferences.numpad": "Tastierino numerico",
     "preferences.numpad.layout": "Layout del tastierino numerico",
     "preferences.numpad.layout.classic": "Classico",
@@ -266,6 +272,11 @@
 
     "support": "Supporto",
     "support.description": "Flow è un progetto realizzato con passione, gratuito e aperto a tutti. Se trovi Flow utile, considera di aiutare il progetto a crescere! Ecco alcuni modi per farlo:",
+    "support.leaveAReview": "Lascia una recensione",
+    "support.leaveAReview.description": "Puoi valutare Flow e lasciare una recensione su {appStore}",
+    "support.leaveAReview.action": "Valuta Flow",
+    "support.starOnGitHub": "Metti una stella su GitHub",
+    "support.starOnGitHub.description": "Mettere una stella a Flow su GitHub aiuta le persone a scoprire Flow",
     "support.requestFeatures": "Dacci idee",
     "support.requestFeatures.description": "Puoi anche supportarci dando feedback e suggerendo idee per migliorare Flow.",
     "support.requestFeatures.action": "Visita il tracker di problemi",
@@ -331,6 +342,7 @@
     "enum.TransactionSubtype@transactionFee": "Commissione transazione",
     "enum.TransactionSubtype@givenLoan": "Prestito (dato)",
     "enum.TransactionSubtype@receivedLoan": "Prestito (ricevuto)",
+    "enum.TransactionSubtype@updateBalance": "Aggiorna saldo",
     "enum.TransactionType": "Tipo di transazione",
     "enum.TransactionType@income": "Entrata",
     "enum.TransactionType@expense": "Spesa",

assets/l10n/mn_MN.json

@@ -86,6 +86,10 @@
     "account.excludeFromTotalBalance.description": "Энэ сонголтыг идэвхжүүлбэл энэ дансны үлдэгдэл нийт үлдэгдэлд бодогдохгүй. Хадгаламж, хувийн бус данс гэх мэт зүйлсд тохиромжтой.",
     "account.updateBalance": "Үлдэгдэл өөрчлөх",
     "account.updateBalance.transactionTitle": "Үлдэгдэл өөрчлөв",
+    "account.updateBalance.chooseUpdateMode": "Үлдэгдэл өөрчлих горим",
+    "account.updateBalance.updateCurrent": "Одоогийн үлдэгдэл өөрчлөх",
+    "account.updateBalance.updateAtDate": "Өнгөрсөн үлдэгдэл өөрчлөх",
+    "account.updateBalance.updateAtDate.description": "Тодорхой хугацаан дахь үлдэгдлээ мэдэж байгаа үед тохиромжтой",
     "account.new": "Шинэ данс нэмэх",
     "account.edit": "Данс засварлах",
     "account.edit.selectCurrency": "Валют сонгох",
@@ -148,6 +152,7 @@
     "transactions.query.filter.categories.all": "Бүх ангилал",
     "transactions.query.filter.groupBy": "Бүлэглэх нэгж",
     "transactions.query.filter.sort": "Эрэмбэ",
+    "transactions.query.filter.currency": "Валют",
     "transactions.count": "{} гүйлгээ",
 
     "category": "Ангилал",
@@ -176,6 +181,7 @@
     "preferences.theme.other": "Бусад үзэмжүүд",
     "preferences.theme.themeChangesAppIcon": "Аппын дүрс дагаж өөрчлөх",
     "preferences.theme.enableDynamicTheme": "Динамик үзэмж",
+    "preferences.theme.enableOledTheme": "OLED горим",
     "preferences.numpad": "Тоон товчлуур",
     "preferences.numpad.layout": "Тооны байрлал",
     "preferences.numpad.layout.classic": "Хуучны",
@@ -266,6 +272,11 @@
 
     "support": "Дэмжих",
     "support.description": "Flow бол үнэгүй, хүн бүрд нээлттэй, хайр шингээж бүтээсэн төсөл юм. Хэрэв Flow танд тус болж байвал та төсөлд өөрийн хувь нэмрээ оруулах боломжтой шүү. Жишээлбэл:",
+    "support.leaveAReview": "Үнэлгээ өгөх",
+    "support.leaveAReview.description": "Та {appStore}-д үнэлгээ өгч, сэтгэгдэл үлдээх боломжтой",
+    "support.leaveAReview.action": "Flow-г үнэлэх",
+    "support.starOnGitHub": "GitHub од өгөх",
+    "support.starOnGitHub.description": "Од нь Flow-г илүү олон хүнд хүрэхэд туслана",
     "support.requestFeatures": "Санаагаа хуваалц",
     "support.requestFeatures.description": "Та өөрийн санал хүсэлтээ бидэнд хэлснээр Flow-г сайжруулахад туслах боломжтой.",
     "support.requestFeatures.action": "Төлөвлөгөө/асуудлууд харах",
@@ -331,6 +342,7 @@
     "enum.TransactionSubtype@transactionFee": "Гүйлгээний шимтгэл",
     "enum.TransactionSubtype@givenLoan": "Өгсөн зээл",
     "enum.TransactionSubtype@receivedLoan": "Авсан зээл",
+    "enum.TransactionSubtype@updateBalance": "Үлдэгдэл өөрчлөх",
     "enum.TransactionType": "Гүйлгээний төрөл",
     "enum.TransactionType@income": "Орлого",
     "enum.TransactionType@expense": "Зарлага",