Skip to content

Shashwat-19/Expense-Tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

65 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“Œ Expense Tracker

HTML CSS JavaScript Firebase Status License Platform

Project Banner

πŸš€ Overview

The Expense Tracker is a lightweight and user-friendly web application that allows users to efficiently manage and monitor their daily expenses.
It helps users track income, expenses, and balance β€” promoting better financial discipline and budgeting habits.

πŸ”Ή Use Cases:

  • Personal daily/weekly expense management
  • Student budgeting
  • Small business simple bookkeeping

πŸ”Ή Target Audience:

  • Students, working professionals, freelancers, small business owners

🎯 Key Features

  • βœ… Add, edit, and delete income and expenses easily
  • βœ… Real-time balance update
  • βœ… Clean and responsive UI
  • βœ… Firebase-backed data persistence
  • βœ… Scalable and modular architecture
  • βœ… High performance and optimized for efficiency

πŸ› οΈ Tech Stack & Tools

  • Languages: HTML, CSS, JavaScript
  • Database: Firebase Firestore
  • Cloud & DevOps: Firebase Hosting, GitHub Actions (CI/CD)
  • Other Tools: Firebase CLI, Prettier for formatting

πŸš€ Live Demo

Try out the Expense Tracker App directly by visiting:
πŸ‘‰ Live Demo


πŸ“¦ Latest Release: v1.0.0

Expense-Tracker v1.0.0 is live! πŸŽ‰

πŸ“¦ Installation & Setup

πŸ”§ Prerequisites

  • Ensure you have the following dependencies installed:
    • Node.js (v18 or above)
    • Firebase CLI
    • Git

πŸš€ Quick Start

# Clone the repository
git clone https://github.com/yourusername/expense-tracker.git

# Navigate to the project directory
cd expense-tracker

# Install Firebase CLI globally (if not already installed)
npm install -g firebase-tools

# Set up environment variables
cp .env.example .env  # Create your .env file based on example

# Login to Firebase
firebase login

# Start the application locally
firebase emulators:start

πŸš€ Usage Guide

# To deploy on Firebase Hosting
firebase deploy

πŸ—οΈ Project Architecture

expense-tracker/
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ icon.png
β”‚   └── image.png
β”œβ”€β”€ firebase/
β”‚   └── auth.js
β”œβ”€β”€ index.html         (Main App)
β”œβ”€β”€ landing.html       (Landing Page)
β”œβ”€β”€ login.html         (Login/Register Page)
β”œβ”€β”€ tracker.css        (App Styles)
β”œβ”€β”€ tracker.js         (App Logic)
β”œβ”€β”€ style.css          (Landing/Login Styles)
β”œβ”€β”€ script.js          (Landing/Login Logic)
β”œβ”€β”€ README.md
β”œβ”€β”€ .gitignore
β”œβ”€β”€ Code of Conduct
β”œβ”€β”€ Security
└── LICENSE

πŸ§ͺ Testing

Manual Testing:

  • Add, edit, and delete transactions
  • Check UI responsiveness
  • Test Firebase integration
  • Confirm balance updates correctly

πŸ“Š Performance Optimization

  • Hosting CDN enabled for faster load times
  • Minified JavaScript and CSS
  • Optimized images for web
  • Indexed database reads (Firebase Firestore)

πŸ“– Documentation

Detailed configuration and developer guidelines will be available inside the /docs folder (coming soon).


πŸ’‘ Contribution Guidelines

Fork the repository
Create a new branch (git checkout -b feature-branch)
Commit changes (git commit -m "Added new feature")
Push to the branch (git push origin feature-branch)
Open a pull request

πŸ“± Browser Support

  • Chrome (last 2 versions)
  • Firefox (last 2 versions)
  • Safari (last 2 versions)
  • Edge (last 2 versions)

πŸ“œ License

Copyright (C) 2023-2024 Shashwat

This project is licensed under the MIT License. See the LICENSE file for details.


πŸ“© Contact

Shashwat

Software Developer | Cloud & DevOps Enthusiast

πŸ”Ή Java Backend Development
πŸ”Ή Cloud Architecture & Containerization
πŸ”Ή DevOps & Scalable Systems

πŸš€ Open Source | Tech Innovation

Passionate about building scalable applications and contributing to transformative tech solutions.

πŸ“Œ Find me here:

About

A simple app for managing daily expenses. Users can add, categorize, view, and track spending, with monthly summaries and secure authentication.

Topics

Resources

License

Code of conduct

Security policy

Stars

0 stars

Watchers

1 watching

Forks

Contributors