Aspend

Your money, tracked — quietly, privately, beautifully.

Why Aspend • Screens • Features • Tech Stack • Getting Started • Contributing

---

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

💳 Track Every Amount A single glance tells you everything: total balance, income vs. expense, and your full transaction history — right from the Home screen.
	🔍 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.
🧾 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.
	👥 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.

---

🚀 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.    │
└───────────────────────────────────────┴────────────────────────────────┘

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

---

🛠️ 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
• ✅ Dart SDK
• ✅ IDE (VS Code, Android Studio, etc.)

2. 🛠 Installation

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

---

📚 Flutter Resources

• 🧪 Write your first Flutter app
• 🍳 Flutter Cookbook (UI examples)
• 📖 Flutter Docs & API Reference

---

🤝 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 file for details.

---

📬 Contact & Channels

Connect for feature requests, bug reports, or discussion:

_{Made with 💚 using Flutter}