diff --git a/README.md b/README.md index 5eb0acd..7345f17 100644 --- a/README.md +++ b/README.md @@ -1,80 +1,104 @@ -![preview](https://i.ibb.co/6Rn265Br/free-icon-gold-coin-17307730.png) +

+ Casha logo +

-**Casha** is a clean and minimal personal finance tracker for Android. It provides an intuitive way to manage your income and expenses with real-time balance tracking, budget control, and multi-currency support. +

Casha

-Casha is the **"Simplest"**, **"Most Elegant"**, and **"Most Focused"** way to take control of your personal finances on Android. +

+ A personal finance tracker that doesn't get in your way. +

+ +

+ + + +

--- -## ✨ Features +Most finance apps make you feel like you're filing taxes. Casha doesn't. +It's built around one idea: tracking your money should take seconds, not minutes. Clean interface, zero clutter, everything exactly where you'd expect it. -- **Balance Card** — gyroscope-powered 3D tilt animation with live currency conversions (USD, EUR, BYN, RUB) -- **Income & Expense tracking** — categorized transactions with icons, notes, and date -- **Monthly Budget** — visual progress bar with over-budget warning -- **Search & Filter** — instant search through transactions with All / Income / Expense filters -- **Biometric Lock** — optional fingerprint protection on app launch -- **Dark & Light theme** — automatic system theme support -- **Multi-currency** — choose your primary currency in settings -- **Amount formatting** — compact (1.2K) or full number display +--- + +## What it does + +Casha gives you a real-time picture of your finances without overwhelming you with features you'll never use. Add a transaction in two taps, see your balance update instantly, know exactly how far into your monthly budget you are — all from a single screen. + +It's not trying to be a spreadsheet. It's trying to be the app you actually open. + +--- + +## ✦ Features + +**Balance Card** +The centerpiece of the dashboard. Your total balance, rendered on a customizable gradient card with a gyroscope-powered 3D tilt effect. Long-press to edit the gradient colors and type — linear, radial, sweep, or solid. + +**Income & Expense Tracking** +Every transaction gets a category, an icon, an optional note, and a date. The list is instantly searchable and filterable by type. Nothing is buried. + +**Category Breakdown** +A dedicated screen with pie and bar charts showing exactly where your money comes from and where it goes. Switch between expenses and income with a single tap. + +**Monthly Budget** +Set a spending limit and watch a progress bar fill up in real time. Goes red when you're over — politely, not aggressively. + +**Multi-currency Support** +USD, EUR, BYN, RUB — pick your primary currency in settings. Exchange rates are fetched automatically. + +**Biometric Lock** +Optional fingerprint protection on launch. One toggle in settings, zero friction in daily use. + +**Dark & Light Theme** +Follows your system theme automatically. Both themes are fully designed — not just inverted colors. + +**Localization** +English and Russian, switchable in settings. Date formats, month names, category labels — everything adapts. + +**Amount Formatting** +Choose between compact (1.2K) or full number display depending on how you think about money. + +--- ## 📱 Screenshots -![screenshot](https://i.ibb.co/Fq06nxKM/screenshot.png) + + + + + + + +
-## 🚀 Getting Started - -### Prerequisites - -- Flutter `^3.11.1` -- Android SDK (min API 21) -- JDK 17+ - -### Installation - -Clone the repository: - -```console -$ git clone https://github.com/koloideal/casha.git -$ cd casha -``` - -Install dependencies: - -```console -$ flutter pub get -``` - -Run in debug mode: - -```console -$ flutter run -``` - -### Build release APK - -```console -$ flutter build apk --release -``` - -### Build for Google Play - -```console -$ flutter build appbundle --release -``` +--- ## 🛠 Tech Stack | Layer | Technology | -|-------|-----------| +|---|---| | Framework | Flutter 3 | | State management | Riverpod | | Navigation | go_router | | Charts | fl_chart | -| Storage | shared_preferences | -| Fonts | Google Fonts | +| Storage | shared_preferences + SQLite | +| Fonts | Google Fonts (Poppins + Nunito) | | Sensors | sensors_plus | | Auth | local_auth | --- -MIT 2025 kolo | made by [kolo](https://t.me/kolo_id) +## 🚀 Getting Started + +**Prerequisites** +- Flutter `^3.11.1` +- Android SDK (min API 21) +- JDK 17+ + +**Clone & run** + +```console +git clone https://github.com/koloideal/casha.git +cd casha +flutter pub get +flutter run diff --git a/assets/flutter_01.png b/assets/flutter_01.png new file mode 100644 index 0000000..68b2c75 Binary files /dev/null and b/assets/flutter_01.png differ diff --git a/assets/flutter_02.png b/assets/flutter_02.png new file mode 100644 index 0000000..962e76d Binary files /dev/null and b/assets/flutter_02.png differ diff --git a/assets/flutter_03.png b/assets/flutter_03.png new file mode 100644 index 0000000..6b4ea9f Binary files /dev/null and b/assets/flutter_03.png differ