discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
sthrnilshaaa/Aspend · source

Snapshot 0 · 2026-11-04T12:47:28Z · Dart · MIT
Content fingerprint
6bfa484d4f9dc52263ad6d5e83a46b32c8952975d0bbe501ef628ae14db11c2e
GitHub description at capture

Privacy-first, offline expense & income tracker for Android built with Flutter and Material You. Auto-detects transactions from bank SMS, voice entry, person-to-person balances, charts, and backups.
README at capture

<p align="center">
  <img src="assets/icons/dark_logo_splash.png" width="100" />
</p>

<h1 align="center">Aspend</h1>
<p align="center"><i>Your money, tracked — quietly, privately, beautifully.</i></p>

<p align="center">
  <img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=22&pause=1200&color=55DF69&center=true&vCenter=true&width=600&lines=Take+Control+of+Your+Money;Track+Every+Amount+Instantly;Know+Where+It+All+Goes;Split+%26+Settle+with+People" />
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=for-the-badge&logo=android&logoColor=white" />
  <img src="https://img.shields.io/badge/Built%20With-Flutter%20%26%20Dart-02569B?style=for-the-badge&logo=flutter&logoColor=white" />
  <img src="https://img.shields.io/badge/UI-Material%20You-4285F4?style=for-the-badge&logo=materialdesign&logoColor=white" />
  <img src="https://img.shields.io/github/downloads/SthrNilshaaa/Aspend/total?style=for-the-badge&logo=GitHub&color=%23000000&cacheBust=1"/>
  <img src="https://img.shields.io/github/stars/SthrNilshaaa/Aspend?style=for-the-badge&logo=GitHub&color=%23000000&cacheBust=1"/>
  <img src="https://img.shields.io/badge/Privacy-100%25%20Offline-55DF69?style=for-the-badge&logo=shield&logoColor=white" />
  <img src="https://img.shields.io/github/v/release/sthrnilshaaa/Aspend?style=for-the-badge&logo=github&color=000000&cacheBust=1" />
  <img src="https://img.shields.io/badge/License-MIT-black?style=for-the-badge" />
</p>

<p align="center">
  <a href="https://play.google.com/store/apps/details?id=org.x.aspend.ns">
    <img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="80">
  </a>
</p>

<p align="center">
  <a href="#-why-aspend">Why Aspend</a> •
  <a href="#-see-it-in-action">Screens</a> •
  <a href="#-features-at-a-glance">Features</a> •
  <a href="#️-tech-stack">Tech Stack</a> •
  <a href="#-getting-started">Getting Started</a> •
  <a href="#-contributing">Contributing</a>
</p>

---

**Aspend** is a modern, privacy-first expense and income tracker built with Flutter, wrapped in a **Material You** interface that adapts to your system's dynamic color palette. Log a transaction in seconds — by hand, by voice, or automatically from a bank SMS — split shared costs with the people around you, and watch it all resolve into balances and charts that actually make sense. No account, no server, no ads. Just your money, on your device.

---

## 💡 Why Aspend?

Most expense trackers make you choose between convenience and privacy. Aspend doesn't.

| | Typical Tracker | **Aspend** |
|---|---|---|
| 🗄️ **Where your data lives** | Cloud account, tied to a login | 100% on-device, in an encrypted local Hive store |
| ✍️ **Logging a transaction** | Manual entry only | Manual, by **voice**, or **auto-detected** from bank SMS/notifications |
| 👥 **Splitting costs with people** | A separate app entirely | Built-in ledger per person, settle up straight through **UPI** |
| 🎨 **Look & feel** | One fixed palette | **Material You** dynamic color, light/dark, custom accents |
| 🌍 **Language** | English, usually | **10 languages** out of the box |
| 🧭 **Learning the app** | Figure it out yourself | One-time **guided tours** for the gestures that aren't obvious |

---

## 📱 See It In Action

<table>
<tr>
<td width="45%" valign="middle">

### 💳 Track Every Amount
A single glance tells you everything: total balance, income vs. expense, and your full transaction history — right from the Home screen.

</td>
<td width="55%">
<img src="screenshots/01.png" width="100%"/>
</td>
</tr>
<tr>
<td width="55%">
<img src="screenshots/02.png" width="100%"/>
</td>
<td width="45%" valign="middle">

### 🔍 Find Anything, Instantly
Filter by Day, Week, Month, or Year, and search by note, category, or person — your full history is always one search away.

</td>
</tr>
<tr>
<td width="45%" valign="middle">

### 🧾 Know Where It Goes
Tap any transaction for the full picture — account, category, timestamp, notes, and attachments — with edit and delete one thumb-reach away.

</td>
<td width="55%">
<img src="screenshots/03.png" width="100%"/>
</td>
</tr>
<tr>
<td width="55%">
<img src="screenshots/04.png" width="100%"/>
</td>
<td width="45%" valign="middle">

### 👥 Split & Settle with People
Add anyone you regularly share expenses with. Aspend keeps a running ledger of who owes whom, and settling up is a single tap away through UPI — no more mental math, no more awkward reminders.

</td>
</tr>
</table>

---

## 🚀 Features at a Glance

```
┌────────────────────────────────────────────────────────────────────────┐
│                            ASPEND FEATURES                             │
├───────────────────────────────────────┬────────────────────────────────┤
│ 💳 SMART BALANCE TRACKING             │ 🤖 AUTO TRANSACTION DETECTION  │
│  Real-time balance, income & expense  │   Detects transactions straight│
│  totals with Day/Week/Month/Year      │   from bank SMS & notifications│
│  filtering.                           │   — parsed 100% on-device.     │
├───────────────────────────────────────┼────────────────────────────────┤
│ 👥 SPLIT & TRACK WITH PEOPLE          │ 📊 VISUAL ANALYTICS            │
│  Keep track of who owes you and what  │   Income/expense breakdown, top│
│  you owe, then settle up via UPI.     │   category, trends & daily     │
│                                        │   averages with live charts.   │
├───────────────────────────────────────┼────────────────────────────────┤
│ 🎙️ VOICE-LOGGED TRANSACTIONS          │ 🧭 GUIDED POINTER TOURS        │
│  Hold the mic, say what you spent,    │   One-time hints for gestures  │
│  release — it's logged.               │   that aren't obvious at a     │
│                                        │   glance.                      │
├───────────────────────────────────────┼────────────────────────────────┤
│ 🎨 MATERIAL YOU THEMING               │ 🔒 PRIVATE & OFFLINE-FIRST     │
│  Dynamic system color, light/dark     │   All data stored locally with │
│  mode, and custom app colors.         │   Hive — optional biometric    │
│                                        │   App Lock included.           │
├───────────────────────────────────────┼────────────────────────────────┤
│ 💾 BACKUP & EXPORT                    │ 🌍 MULTI-LANGUAGE              │
│  Full JSON backup/restore, CSV        │   Fully localized into 10      │
│  export, and PDF statements.          │   languages out of the box.    │
└───────────────────────────────────────┴────────────────────────────────┘
```

<p align="center">
🇬🇧 English &nbsp;·&nbsp; 🇮🇳 हिन्दी &nbsp;·&nbsp; 🇪🇸 Español &nbsp;·&nbsp; 🇫🇷 Français &nbsp;·&nbsp; 🇩🇪 Deutsch &nbsp;·&nbsp; 🇯🇵 日本語 &nbsp;·&nbsp; 🇵🇹 Português &nbsp;·&nbsp; 🇷🇺 Русский &nbsp;·&nbsp; 🇸🇦 العربية &nbsp;·&nbsp; 🇨🇳 中文
</p>

---

## 🛠️ Tech Stack

```
        ┌────────────────────────────────────────────────────────┐
        │                  ASPEND ARCHITECTURE                   │
        ├────────────────────┬───────────────────────────────────┤
        │  UI Framework      │  Flutter & Dart (Material 3)      │
        ├────────────────────┼───────────────────────────────────┤
        │  Local Database    │  Hive (fast, offline NoSQL)       │
        ├────────────────────┼───────────────────────────────────┤
        │  State Management  │  Provider                         │
        ├────────────────────┼───────────────────────────────────┤
        │  Charts            │  fl_chart                         │
        ├────────────────────┼───────────────────────────────────┤
        │  Onboarding Tours  │  showcaseview                     │
        ├────────────────────┼───────────────────────────────────┤
        │  Security          │  local_auth (biometric App Lock)  │
        └────────────────────┴───────────────────────────────────┘
```


## 🚀 Getting Started

### 1. 📋 Prerequisites

- ✅ [Flutter SDK](https://docs.flutter.dev/get-started/install)
- ✅ Dart SDK
- ✅ IDE (VS Code, Android Studio, etc.)

### 2. 🛠 Installation

```bash
git clone https://github.com/sthrnilshaaa/Aspend.git
cd Aspend
flutter pub get
flutter run
```

---

## 📚 Flutter Resources

* [🧪 Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
* [🍳 Flutter Cookbook (UI examples)](https://docs.flutter.dev/cookbook)
* [📖 Flutter Docs & API Reference](https://docs.flutter.dev/)

---

## 🤝 Contributing

Have a suggestion or found a bug? Contributions are welcome!

1. Fork the repository
2. Create a branch (`git checkout -b feature-name`)
3. Commit your changes (`git commit -m 'Add new feature'`)
4. Push to the branch (`git push origin feature-name`)
5. Open a Pull Request

---

## 👥 Contributors

### Core Team
* **Nilesh Suthar** — *Creator & Lead Developer*
* **Hitesh Suthar** — *Developer*
* **Karan Suthar** — *UI/UX & Interaction Design*

---

## 📄 License

This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.

---

## 📬 Contact & Channels

Connect for feature requests, bug reports, or discussion:

[![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sthrnilshaaa)
[![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/aspends_supports)

<p align="center">
  <sub>Made with 💚 using Flutter</sub>
</p>