BudgetBrain

BudgetBrain — Project Overview BudgetBrain is a full-stack AI-powered personal finance tracker that helps users manage income, expenses, and budgets with intelligent insights powered by Google Gemini AI. It features a premium fintech-grade UI inspired by apps like CRED and Groww.

What It Does Feature Description Dashboard Real-time balance, income, expenses, savings rate & financial health score Transactions Add/edit/delete with search, filters, categories, pagination & CSV export Budgets Category-wise monthly budgets with progress bars & overspending alerts Analytics Interactive Area, Pie & Bar charts with trend analysis AI Chatbot Ask anything about your finances — powered by Gemini AI Reports Auto-generated monthly financial report with A–F grading AI Predictions Spending forecasts & anomaly detection AI Budget Planner Smart 50/30/20 budget recommendations

Architecture Client (React + Vite) → Vite Proxy → Express API (18 endpoints) → MongoDB ↓ Google Gemini AI MVC pattern on backend (Models → Controllers → Routes) Context API on frontend (AuthContext, ThemeContext) JWT auth flow — signup → hash password → issue token → protect routes AI pipeline — fetch user data → build structured prompt → send to Gemini → parse JSON response → render on frontend By the Numbers Metric Value Total files 58 Lines of code 12,500+ API endpoints 18 AI features 6 Frontend pages 7 Reusable components 6 Mongoose models 3 Seeded transactions 250+