- Total Balance Display: Shows the current balance based on your income and expenses.
- Income and Expense Overview: Displays total income and total expenses separately.
- Add Transactions: Allows you to easily add new transactions (either income or expense).
- Transaction History: View a complete list of all past transactions sorted according to date.
- Filter Feature: Filter your transaction history to view only income, only expenses, or all transactions.
- Add Transaction: Use the "Add Transaction" section to log your income or expenses. Specify whether it’s an income or expense, and enter the amount and further details.
- View Total Balance: The dashboard displays your current balance, total income, and total expenses at a glance.
- View Transaction History: The history section shows all your recorded transactions, ordered by date, making it easy to see how you've been spending or earning over time.
- Filter Transactions: You can filter the transaction list by income, expenses, or view all at once.
- HTML
- CSS
- JavaScript
To contribute to Budget Buddy, follow these steps:
- Fork the Repository: Click the "Fork" button at the top of this repository.
- Create a New Branch: Before cloning, if you are working on a New Feature or Major Change, create a new branch first. Use a descriptive name like
feature/add-dark-modeorfix/complex-auth-issue. (Note: Minor bug fixes can be done directly on main, see Contribution Guidelines below.) - Clone your Fork: Clone your repository and your new branch (if applicable) to your local machine.
# For a new feature or major fix: git clone -b your-new-branch-name https://github.com/your-username/BudgetBuddy.git # For a quick bug fix : git clone https://github.com/your-username/BudgetBuddy.git
- Navigate to the Project Directory:
cd BudgetBuddy - Run Locally: Use VS Code's Live Server extension or an equivalent tool to run
index.html.
Feel free to contribute to Budget Buddy! To ensure a smooth and efficient process, please follow these guidelines:
- For minor bug fixes (e.g., typos, small style tweaks, single-line corrections), you may submit a Pull Request directly to the
mainbranch.
- For new features, substantial changes, or complex bug fixes, you must work in a separate branch and follow this process:
- Open an Issue First: Please open an issue to discuss the change before you start coding.
- Get Assigned: Wait for a maintainer to assign the issue to you. This prevents duplicate work.
- Submit a Pull Request (PR): Only open a Pull Request after your issue has been assigned and you have committed your changes to your new branch.

