Skip to content

Muhammad-Ali-70/Expenzo

Repository files navigation

Version Platform License

Expenzo

Personal Finance, Simplified.

Track every rupee. Plan every month. Take control of your money.


📖 About

Expenzo is a personal finance management app that helps you track expenses, manage accounts, set monthly budgets, and monitor debts — all in one place. Built for individuals who want a clear, real-time picture of where their money is going without the complexity of traditional finance tools.

Whether you're managing cash, a bank account, or a digital wallet, Expenzo adapts to how you handle your money.


✨ What You Can Do

Track Every Transaction

Log expenses and income in seconds. Categorize spending, add notes, and review your history with powerful filters.

Manage All Your Accounts

Add multiple accounts — wallets, bank accounts, digital wallets (JazzCash, Easypaisa, NayaPay, etc.) — and see your total balance at a glance.

Plan with Monthly Budgets

Set a monthly spending limit and optionally assign budgets per category. Visual progress bars show you how much is left, with color-coded warnings when you're close to the limit.

Stay on Top of Debts

Track money you owe or are owed. Add interest rates, set due dates, send reminders, and record partial payments.

Get Notified

Receive in-app alerts when you're approaching or exceeding your budget, so you're always aware before it's too late.

Export Your Data

Download your full transaction history as a CSV file or have it sent directly to your email.


🎨 Design & Experience

  • Dark & Light Modes — Seamless theme that follows your system preference or manual toggle.
  • Clean Interface — Built with a focus on readability and quick interactions.
  • Responsive Layout — Optimized for phones of all sizes.

🧱 Built With

Layer Technology
Mobile Framework React Native
State Management Zustand
Local Storage MMKV
Navigation React Navigation
Charts Gifted Charts
Backend Node.js + Express
Database MongoDB
Authentication JWT + bcrypt
Animations Lottie

🚀 Getting Started

Prerequisites

  • Node.js 18 or later
  • Android Studio (for Android) or Xcode (for iOS)
  • React Native CLI (setup guide)

Install & Run

# Clone the project
git clone https://github.com/your-org/Expenzo.git
cd Expenzo

# Install dependencies
npm install

# Start Metro bundler
npx react-native start

# In a second terminal, run the app
npx react-native run-android   # for Android
# or
npx react-native run-ios       # for iOS

Note: The app requires the Expenzo backend to be running. See the backend repository for setup instructions.


📱 App Preview

Screen Description
Dashboard Monthly spending summary, daily chart, recent activity, account balances
Transactions Add expenses/income with category, account, date, and notes
History Scroll through past transactions with search and filter by type, account, date, or amount
Budget Planner Set monthly budgets, view category breakdowns, track spending vs limits
Debt Tracker Manage outstanding and receivable debts with interest and reminders
Settings Profile, theme toggle, currency, account list, export
Notifications Budget alerts and category warnings in one place

🗺️ What's Coming Next

  • Push notifications for budget alerts
  • Multi-currency support
  • Spending insights and trends
  • Budget template presets
  • Cloud sync and backup
  • Biometric authentication
  • Receipt scanning

🐛 Reporting Issues

Found a bug or have a suggestion? Open an issue on the GitHub repository.


📄 License

Expenzo is released under the MIT License.


Made with focus — for people who want to master their money.

About

Expenzo is a personal finance management app that helps you track expenses, manage accounts, set monthly budgets, and monitor debts — all in one place. Built for individuals who want a clear, real-time picture of where their money is going without the complexity of traditional finance tools.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages