mirror of
https://github.com/koloideal/Casha.git
synced 2026-06-10 10:25:28 +03:00
81 lines
1.9 KiB
Markdown
81 lines
1.9 KiB
Markdown
|
|
|
|
**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 is the **"Simplest"**, **"Most Elegant"**, and **"Most Focused"** way to take control of your personal finances on Android.
|
|
|
|
---
|
|
|
|
## ✨ Features
|
|
|
|
- **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
|
|
|
|
## 📱 Screenshots
|
|
|
|
|
|
|
|
## 🚀 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 |
|
|
| Sensors | sensors_plus |
|
|
| Auth | local_auth |
|
|
|
|
---
|
|
|
|
MIT 2025 kolo | made by [kolo](https://t.me/kolo_id)
|