8000 GitHub - socode-dev/smartbudget
[go: up one dir, main page]

Skip to content

socode-dev/smartbudget

Repository files navigation

💰 SmartBudget

SmartBudget is a modern personal finance manager that goes beyond simple tracking. It combines rule-based insights and ML-Powered inntelligence to help you understand your spending, stay on budget and make smarter financial decision, all in a fast, responsive and beautifully designed web app.


🚀 Live Demo 🔗 Preview Demo

🚀 Features

  • Dashboard Overview : Get a complete snapshot of your finances at a glance.
  • Transactions : Log, view and manage your income and expenses effortlessly.
  • Budgets : Create budgets per category and receive proactive alerts before overspending.
  • Goals : Define financial goals with time-based tracking.
  • Smart Insights :
    • Rule-based insights (spending patterns and budget tracking).
    • ML-Powered insights (anomaly detection and cashflow forecasting).
  • Reports : Interactive charts for deep spending breakdowns and also export activities in PDF/CSV.
  • In-App Notifications : Instantly get notified when you hit any of your set thresholds(transaction, budget and goals).
  • Smooth UX : Page transitions, modal and skeleton loaders with animation.
  • Performance Optimized : Lazy loading and SEO-friendly setup.
  • Persistence & Security : Firestore as the backend, Zustand for state management, Firebase Auth for secure access.

⚒️ Tech Stack

  • Frontend : React, Zustand, TailwindCSS, chart.js, Framer Motion
  • Backend : Firebase (Firestore, Auth)
  • ML/AI : TensorFlow.js(Unsupervised anomaly detection + forecasting model)
  • Testing : Vitest
  • Build Tool : Vite

📦 Installation & Setup

git clone https://github.com/socode-dev/smartbudget.git

cd smartbudget npm install npm run dev


🧪 Testing

npm run test


📂 Project Structure

-public/ -src/ ----components/ ----context/ ----data/ ----firebase/ ----hooks/ ----initializer/ ----layout/ ----ml/ ----pages/ ----routes/ ----schema/ ----store/ ----tests/ ----utils/ ----App.jsx ----main.css ----main.jsx -index.html


📝 License

MIT License © 2025

About

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

0