BudgetBuddy is an AI-Powered Advanced Personal finance tracker aka wealth management app that helps users manage expenses and savings effectively. Built with modern web technologies, it offers a seamless experience for tracking financial transactions and generating insightful reports.
Take control of your monthly spend limits with completely overhauled planning tools.
- ✨ Auto-Suggest Budgets: Sick of manual entry? Calculate a rolling 3-month average for your typical categories instantly. It even smartly recommends a 5% reduction on discretionary/luxury categories to quietly enforce saving.
- 📅 Multi-Month Grid View: Toggle to an Excel-like annual layout to plan ahead for Christmas in July or annual car insurance premiums, side-by-side with your active card view.
- 🧹 End-of-Month Savings Sweep: Don't let your unspent budget vanish! A smart banner detects unused funds at the end of the month and helps you "sweep" them directly into your savings goals.
Secure your digital heritage and emergency information with bank-grade PIN protection.
- PIN-Based Access: Multi-layered security with a dedicated PIN overlay for sensitive data.
- Digital Heritage: Store insurance, legal, crypto, and medical records securely.
- Beneficiary Management: Designate trusted contacts to access your vault in case of emergencies.
- Categorized Security: Organize sensitive information with custom sensitivity levels and categories.
Manage finances together in isolated, shared environments with role-based access control.
- Multiple Workspaces: Create separate workspaces for Family, Business, or Personal use.
- Role-Based Access Control: Invite members via email with specific roles (Admin, Editor, Viewer).
- Real-Time Activity Feed: Track exactly who added, edited, or deleted transactions within the workspace.
- Workspace-Scoped Data: Transactions, budgets, categories, and analytics are securely isolated per workspace.
BudgetBuddy features a world-class AI Financial Analyst that evolves with your spending habits. It's not just a chatbot; it's a proactive intelligence engine.
- Anomaly Detection: Automatically scans your history to flag unusual spending spikes with Smart Alerts
⚠️ . - Predictive Forecasting: Projects your end-of-month spending vs. budget with Confidence Scores 🔮.
- Automated Recaps: Daily and Weekly summaries that track trends, savings growth, and provide actionable Budget Buddy Tips 🗓️.
- Persona-Driven Advice: Adapts its personality based on your behavior—meet the Squirrel (Saver), Peacock (Spender), Owl (Strategist), or Fox (Balanced).
- Streak Tracking: Stay motivated with Budget Adherence Streaks and level up your financial discipline 🔥.
- Achievement System: Unlock literal achievements for hitting milestones, celebrated with Dynamic Confetti explosions 🎊.
- Voice-to-Action: "Add $50 for coffee" — speak naturally and watch the AI execute actions instantly 🎤.
- Auto-Execution: Voice commands trigger real-time transactions and tool calls without pressing "Send".
- Text-to-Speech: Professional voice narration for all AI insights and responses.
The AI embeds functional, reactive components directly in your chat:
- Budget Adjuster: Modify your monthly limits inline with increment/decrement controls.
- Transaction Cards: Instant access to Edit/Delete transactions within the chat flow.
- Goal Progress: Visualized milestones for savings goals with celebration badges.
- Rich Visualizations: Interactive Bar Charts, Pie Charts, Heatmaps, and Trend Lines.
- Export PDF Report: Instantly generate and download a professional-grade PDF of your chat history and financial insights with one click.
- Transaction Tracking: Log income and expenses with smart categorization.
- Budgeting: Create monthly budgets for specific categories and get alerted when you're close to limits.
- Savings Goals: specific financial milestones (e.g., "New Car") and track contribution progress.
- Asset Tracking: Monitor your net worth by tracking assets alongside your cash flow.
- Legacy Vault: A secure sanctuary for your digital heritage, crypto keys, and medical records.
- PIN-Protected Access: Secure sensitive vault data with a dedicated, multi-layered PIN system.
- Beneficiary Trust: Designate trusted contacts to access your vital information in case of emergencies.
- Privacy Mode: Instantly mask sensitive numbers and balances for safe use in public spaces.
- Bank-Grade Encryption: Your financial data is protected with industry-leading security protocols.
- Real-time Dashboard: Interactive charts showing cash flow, spending trends, and category breakdowns.
- Comparative History: Analyze period-over-period performance (Weekly, Monthly, Yearly).
- Multi-Currency: Full support for global currencies with user-selectable display formats.
- Data Export: Download your complete financial history in CSV or PDF formats.
- Glassmorphism UI: A sleek, modern interface built with Shadcn UI and translucency effects.
- Theme Customization: Switch between light/dark modes and customize primary colors.
- Fully Responsive: Optimized experience for phones, tablets, and large desktop screens.
- Offline Mode: Visual indicators and safe-guards for when you lose connectivity.
BudgetBuddy utilizes a robust relational schema designed for workspace isolation and detailed financial tracking.
- Framework: Next.js 15 (App Router)
- Core: React 19, TypeScript
- Styling: Tailwind CSS, Shadcn UI
- Motion: Framer Motion (Animations & Drag-and-Drop)
- State/Fetching: TanStack Query
- Visualization: Recharts
- Icons: Lucide React
- Utilities: date-fns, React CountUp
- UI Components: cmdk, Sonner, Vaul, Emoji Mart
- Effects: Canvas Confetti
- Database: PostgreSQL (via Prisma ORM)
- Auth: Clerk (Secure User Management)
- AI Models: Groq (Llama 3.3), OpenRouter (GPT-4o)
- File Uploads: UploadThing
- Data Export: jspdf, export-to-csv
- Validation: Zod
- Node.js (v18+)
- PostgreSQL Database URL (Local or Cloud e.g., Neon, Supabase)
- Clerk Account (Public/Secret Keys)
-
Clone the repository:
git clone https://github.com/devhimanshuu/BudgetBuddy.git cd BudgetBuddy -
Install dependencies:
npm install
-
Set up Environment Variables: Create a
.envfile in the root directory:# Database DATABASE_URL="postgresql://user:pass@localhost:5432/budgetbuddy" # Authentication (Clerk) NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_... CLERK_SECRET_KEY=sk_test_... NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
-
Initialize Database:
npx prisma generate npx prisma db push
-
Run the Development Server:
npm run dev
Open http://localhost:3000 to view the app.
Contributions are welcome! Please follow these steps:
- Fork the repo.
- Create a feature branch (
git checkout -b feature/NewThing). - Commit your changes.
- Push to the branch.
- Open a Pull Request.
Created by Himanshu Gupta.
- Twitter: @devhimanshuu
- Email: devhimanshuu@gmail.com