stableee

2026-06-10 02:15:29 +03:00 · 2026-03-22 01:45:58 +03:00
parent 240318bd11
commit c9032077bd
4 changed files with 81 additions and 57 deletions
@@ -1,80 +1,104 @@
-![preview](https://i.ibb.co/6Rn265Br/free-icon-gold-coin-17307730.png)
+<p align="center">
+  <img src="https://i.ibb.co/6Rn265Br/free-icon-gold-coin-17307730.png" width="88" alt="Casha logo" />
+</p>

-**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.
+<h1 align="center">Casha</h1>

-Casha is the **"Simplest"**, **"Most Elegant"**, and **"Most Focused"** way to take control of your personal finances on Android.
+<p align="center">
+  A personal finance tracker that doesn't get in your way.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Flutter-3.11+-02569B?logo=flutter" />
+  <img src="https://img.shields.io/badge/Platform-Android-3DDC84?logo=android" />
+  <img src="https://img.shields.io/badge/License-MIT-lightgrey" />
+</p>

 ---

-## ✨ 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)
+<table>
+  <tr>
+    <td><img src="https://i.ibb.co/Fq06nxKM/screenshot.png" width="180" /></td>
+    <td><img src="https://i.ibb.co/tPk9GVsn/flutter-01.png" width="180" /></td>
+    <td><img src="https://i.ibb.co/DP0LBnK4/flutter-03.png" width="180" /></td>
+    <td><img src="https://i.ibb.co/xtQ8MQNL/flutter-02.png" width="180" /></td>
+  </tr>
+</table>

-## 🚀 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