![preview](https://i.ibb.co/6Rn265Br/free-icon-gold-coin-17307730.png)

**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

> _Add your screenshots here_

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