Skip to content

README.md

Latest commit

 

History

History
126 lines (94 loc) · 3.86 KB

README.md

File metadata and controls

126 lines (94 loc) · 3.86 KB

Spendrix 💰

Smart Money Management Made Simple

Spendrix is a modern, intuitive expense tracking application built with Flutter. Track your income, expenses, and manage your finances with ease across all your devices.

Flutter License: MIT Version

✨ Features

💳 Financial Management

  • Transaction Tracking - Record income and expenses with categories
  • Multiple Accounts - Manage multiple bank accounts, wallets, and payment methods
  • Spending Limits - Set daily, weekly, or monthly budget limits per category
  • Lend & Borrow - Track money lent to or borrowed from others

📊 Analytics & Reports

  • Visual Analytics - Beautiful charts and graphs for expense breakdown
  • Custom Reports - Generate reports for any time period
  • Category Insights - See spending patterns by category
  • Budget Progress - Track spending limits with visual indicators

🎨 User Experience

  • Dark Mode - Full support for light and dark themes
  • Modern UI - Clean, intuitive interface with smooth animations
  • Customizable - Toggle features like lend/borrow tracking
  • Responsive - Works seamlessly on phones and tablets

📱 Screenshots

Screenshots coming soon

🚀 Getting Started

Prerequisites

  • Flutter SDK 3.8.1 or higher
  • Dart SDK 3.8.1 or higher
  • Android Studio / Xcode (for mobile development)

Installation

  1. Clone the repository

    git clone https://github.com/kafle1/spendrix.git
cd spendrix

  2. Install dependencies

    flutter pub get

  3. Run the app

    flutter run

🏗️ Project Structure

lib/
├── main.dart                 # App entry point
├── models/                   # Data models
│   ├── account.dart
│   ├── category.dart
│   ├── transaction.dart
│   └── spending_limit.dart
├── screens/                  # UI screens
│   ├── home_screen.dart
│   ├── add_transaction_screen.dart
│   ├── reports_screen.dart
│   ├── lend_borrow_screen.dart
│   └── settings_screen.dart
├── providers/                # State management
│   └── data_provider.dart
├── database/                 # SQLite database
│   └── database_helper.dart
├── utils/                    # Utilities
│   ├── app_theme.dart
│   └── format_utils.dart
└── widgets/                  # Reusable widgets

🛠️ Built With

🤝 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to submit pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Thanks to the Flutter team for the amazing framework
  • Icons from Material Design Icons
  • Inspiration from various personal finance apps

📮 Contact

Niraj Kafle

🗺️ Roadmap

  • Export data to CSV/Excel
  • Cloud sync and backup
  • Receipt scanning with OCR
  • Multi-currency support
  • Recurring transactions
  • Financial goal tracking
  • Bank integration

Made with ❤️ using Flutter