Skip to content

judeotine/SpendWise

Repository files navigation

💰 SpendWise - Personal Budget Tracker

A cross-platform personal finance app built with React, Capacitor, and Firebase to help users track expenses, manage budgets, and visualize spending habits.

📱 SpendWise Mockups

Key Screens Preview


Welcome screen

Insights

Expense

Budget Planner

Settings

Reciept Scanner

Dashboard

Live Demo: spendwise Android APK: Download link coming soon


🚀 Features

  • 📊 Expense Tracking: Log daily transactions with categories
  • 🎯 Budget Management: Set monthly limits per category
  • 📈 Data Visualization: Interactive charts (Powered by Chart.js)
  • 🔐 Secure Auth: Supabase Authentication (Google/Email)
  • 📱 Cross-Platform: Android/iOS/Web via Capacitor
  • 🔄 Offline Sync: Local-first architecture with Firebase backup

🛠️ Tech Stack

Component Technology
Frontend React, TypeScript, Vite
UI Library Material-UI, TailwindCSS
Backend Firebase (Auth, Firestore)
Mobile Capacitor (Android/iOS)
Charts Chart.js
Testing Jest, React Testing Library

🏗️ Setup & Installation

Prerequisites

  • Node.js ≥18
  • Android Studio (for mobile builds)
  • Firebase CLI (if modifying backend)

Local Development

  1. Clone the repo:
    git clone https://github.com/judeotine/SpendWise.git
    cd SpendWise
  2. Install dependencies:
    npm install
  3. Run dev server:
    npm run dev

Android Build

  1. Sync with Capacitor:
    npm run build
    npx cap sync android
  2. Open in Android Studio:
    npx cap open android
  3. Build signed APK:
    Refer to BUILDING.md for signing instructions

📜 License

MIT © Ocen Jude Otine


📬 Contact

For feature requests/bugs, open an issue.
For direct contact: [email protected]


---

About

A finance and budget planner application

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages