Budget-Buddy

Budget Buddy is a zero-based budgeting web app that uses Gemini AI to help users allocate every dollar of income, simplify finances, and build smart, custom budgets with a clean, easy-to-use interface

Comment

💸 Budget Buddy — Your Friendly Financial Sidekick

✨ What Inspired Us

As students juggling school, work, and life, managing money can feel overwhelming. Most budgeting apps out there are bloated or just... boring. We wanted something simple, smart, and a little more human. So we asked ourselves:

"What if we could make budgeting feel more like chatting with a friend?"

That’s how Budget Buddy was born — a web app that helps you track your income, expenses, and budget categories using zero-based budgeting and AI-generated suggestions. Oh, and it talks back — thanks to Gemini AI.

🧠 What We Learned

This project helped us grow in so many ways:

  • 🔧 How to structure a full-stack web app using Express.js, MongoDB Atlas, and React
  • 🌙 Styling with Midnight UI to make it feel clean and friendly
  • 🧠 Integrating Gemini AI to generate budget suggestions and react to user tweaks
  • 🔐 How to manage API keys safely with .env and .gitignore
  • ☁️ Version control with Git & GitHub (including secure commits & rewrites!)

🏗️ How We Built It

Tech Stack:

  • Frontend: React + Midnight UI
  • Backend: Express.js (Node.js)
  • Database: MongoDB Atlas
  • AI: Google Gemini API (gemini-pro-2.0)
  • Version Control: Git + GitHub

How It Works:

  1. 📝 User enters income, recurring expenses, and budget categories
  2. 🧮 We calculate how much is left to distribute
  3. 🧠 Gemini AI generates a smart zero-based budget plan
  4. 🧾 The user can accept, reject, or ask for changes using natural language
  5. 💾 Final budget gets saved to MongoDB and can be revisited later

😅 Challenges We Faced

  • 🧩 Figuring out how to structure backend routes and make them talk cleanly with Gemini
  • 💥 Accidentally pushing .env with an API key (we fixed it and learned from it!)
  • 🧠 Making the AI suggestions feel “human” and useful without overcomplicating the UX
  • 📦 Deploying a working full-stack app in less than 24 hours!

❤️ Why It Matters

Budgeting shouldn’t be a chore or a stressor. We made Budget Buddy to bring peace of mind to people who just want to know:

  • How much do I make?
  • How much can I spend?
  • And how do I stay on top of it all?

Our goal was to keep it simple, smart, and supportive — the way good financial tools should be.

Thanks for reading our story. We hope Budget Buddy helps bring a little clarity and calm to your financial life. 💚

Built With

Share this project:

Updates