Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/contawo/fullstack_budget_app

Start budgeting today with this budget application. Keep track of your expenses and avoid overspending. Start saving your money for those rainy days (if you have one).
https://github.com/contawo/fullstack_budget_app

budget-app expense-manager expressjs html-css-javascript mongoose nodejs

Last synced: 2 days ago
JSON representation

Start budgeting today with this budget application. Keep track of your expenses and avoid overspending. Start saving your money for those rainy days (if you have one).

Awesome Lists containing this project

README

        

# Budget Buddy: Your Personal Finance Tracker 🌟

Hey there! I'm **Awonke Mnotoza**, and welcome to **Budget Buddy**—your trusty companion for managing your finances. Whether you're a penny-pincher or a big spender, this app will help you stay on track. Let's dive into the details and get your budget in shape! 💰

## Overview
**Budget Buddy** is a web application that allows me to track my incomes, expenses, and set budget goals. Here's what it offers:
1. **Income Tracking**: Log your earnings, whether it's your paycheck, freelance gig, or that birthday cash from Grandma.
2. **Expense Management**: Keep an eye on your spending. Add expenses for groceries, bills, dining out, and more.
3. **Budget Goals**: Set a monthly budget and let **Budget Buddy** help you stick to it. No more overspending!

## Tech Stack
### Frontend
- **HTML, CSS, and JavaScript**: The classic trio for building user interfaces.
- **Chart.js**: Display your expenses in beautiful charts.

### Backend
- **Node.js with Express**: My trusty backend framework.
- **Mongoose**: For managing our MongoDB database.

## Getting Started
1. **Clone the Repository**: Get started by cloning this repository to your local machine.
2. **Install Dependencies**:
- Make sure you have Node.js installed.
- Run `npm install` to install project dependencies.
3. **Set Up MongoDB**:
- Create a MongoDB database (either locally or using a cloud service).
- Update your `.env` file with your MongoDB connection string.
4. **Run the Application**:
- I am using vscode, so to run the project within vscode.
- Open any `html` file and right click.
- Click on the option that says `open with live server` (if it is installed).
- Open your extensions tab and install the `live server` if you do not have it installed in your vscode.

## Design Process
In the `design` folder, you'll find a brief overview of my design decisions. I've kept it simple, user-friendly, and focused on functionality.

## License
This project is licensed under the **MIT License**. Feel free to explore, modify, and share. 📜

Remember, every dollar saved is a step toward financial freedom. Happy budgeting! 🤑💸