Skip to content

AegisX-dev/Expense-Tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’° Expense Tracker Pro

Version License JavaScript HTML5 CSS3 Live Demo

A professional-grade, feature-rich web application for comprehensive personal financial management. Built with modern web technologies, this application provides an intuitive interface for tracking expenses, managing budgets, analyzing spending patterns, and maintaining financial health.

🌐 Live Demo

Try Expense Tracker Pro Live

Experience the full functionality of the application with the live demo hosted on Vercel.

πŸ“± Preview

Expense Tracker Pro Dashboard

Modern dashboard with real-time financial overview, interactive charts, and comprehensive expense tracking

✨ Features

🏠 Dashboard & Analytics

  • Real-time Financial Overview - Live statistics with period-over-period comparisons
  • Interactive Charts - Spending trends (line chart) and category breakdown (doughnut chart)
  • Percentage Changes - Visual indicators showing financial trends
  • Recent Transactions - Quick view of latest financial activities

πŸ’³ Transaction Management

  • Quick Add - Fast transaction entry with smart defaults
  • Advanced Filtering - Filter by category, type, date range, or search terms
  • Smart Pagination - Efficient browsing of large transaction lists
  • Real-time Updates - Instant UI updates without page refresh
  • Custom Categories - Create and manage personalized expense categories

πŸ“Š Budget Tracking

  • Monthly Budgets - Set spending limits by category
  • Progress Visualization - Color-coded progress bars with alerts
  • Budget Alerts - Real-time notifications at 80% and 100% usage
  • Overspend Tracking - Clear indicators when budgets are exceeded

🌍 Multi-Currency Support

  • 6 Currencies - USD, EUR, GBP, JPY, CAD, AUD
  • Live Conversion - Automatic conversion of existing data
  • Exchange Rates - Built-in rate management with update functionality
  • Smart Formatting - Currency-appropriate decimal places

🎨 Modern UI/UX

  • Responsive Design - Perfect on desktop, tablet, and mobile
  • Dark/Light Themes - System preference detection and manual toggle
  • Toast Notifications - Elegant, non-intrusive feedback system
  • Loading States - Professional loading indicators for better UX

πŸ“ˆ Data Management

  • Local Storage - Automatic data persistence
  • Export/Import - JSON and CSV format support
  • Data Validation - Comprehensive input validation and error handling
  • Backup & Restore - Complete data backup capabilities

πŸ”” Smart Notifications

  • Budget Alerts - Configurable spending limit warnings
  • Monthly Summaries - Automatic end-of-month financial reports
  • Success Feedback - Confirmation for all user actions
  • Error Handling - Clear, actionable error messages

πŸ›  Technical Details

Architecture

  • Frontend: Vanilla JavaScript (ES6+), HTML5, CSS3
  • Charts: Chart.js 4.4.2
  • Icons: Font Awesome 6.4.0
  • Storage: Browser localStorage
  • Design: CSS Grid, Flexbox, Custom Properties
  • Deployment: Vercel (Static Site Hosting)

Browser Support

  • Chrome 90+ βœ…
  • Firefox 88+ βœ…
  • Safari 14+ βœ…
  • Edge 90+ βœ…
  • Mobile browsers βœ…

Performance

  • Lightweight (~200KB total)
  • Fast loading (<1s on 3G)
  • Smooth animations (60fps)
  • Efficient memory usage

πŸš€ Quick Start

Option 1: Use Live Demo

Visit https://expense-tracker-one-wine.vercel.app/ to use the application immediately without any setup.

Option 2: Local Installation

Prerequisites

  • Modern web browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
  • JavaScript enabled
  • No server setup required

Installation

  1. Clone the repository

    git clone https://github.com/AegisX-dev/Expense-Tracker.git
    cd Expense-Tracker
  2. Open the application

    # Simply open index.html in your browser
    open index.html
    # Or use a local server (recommended)
    python -m http.server 8000
    # Then visit http://localhost:8000
  3. Start tracking!

    • Add your first transaction
    • Set up budgets for your categories
    • Explore the dashboard and analytics

πŸ“± Usage Guide

Adding Transactions

  1. Click "Quick Add" on the Transactions page
  2. Fill in transaction details:
    • Type (Income/Expense)
    • Date (defaults to today)
    • Description
    • Category (or create custom)
    • Amount
    • Payment method
  3. Click "Add Transaction" to save

Managing Budgets

  1. Navigate to the Budget page
  2. Click "Add Budget"
  3. Select category and set monthly limit
  4. Monitor progress with visual indicators
  5. Receive alerts when approaching limits

Viewing Analytics

  1. Visit the Dashboard for overview
  2. Check Analytics page for detailed insights
  3. Use date range selector to analyze different periods
  4. Review percentage changes and trends

Customizing Settings

  1. Go to Settings page
  2. Choose theme (Light/Dark/Auto)
  3. Select preferred currency
  4. Configure notifications
  5. Manage data (export/import/clear)

πŸ“ File Structure

Expense-Tracker/
β”œβ”€β”€ index.html              # Main application file
β”œβ”€β”€ styles.css              # Complete styling system
β”œβ”€β”€ script.js               # Core application logic
β”œβ”€β”€ assets/                 # Static assets
β”‚   β”œβ”€β”€ Favicon.png        # Application favicon
β”‚   └── Preview.png        # Dashboard preview image
β”œβ”€β”€ README.md               # This file
β”œβ”€β”€ CONTRIBUTING.md         # Contribution guidelines
β”œβ”€β”€ INSTALLATION.md         # Detailed setup instructions
└── CHANGELOG.md            # Version history

🌐 Deployment

Vercel (Current)

The application is currently deployed on Vercel at: https://expense-tracker-one-wine.vercel.app/

To deploy your own version:

  1. Fork this repository
  2. Connect to Vercel
  3. Deploy automatically

Other Deployment Options

  • GitHub Pages: Free static hosting
  • Netlify: Continuous deployment from Git
  • Firebase Hosting: Google's hosting platform
  • AWS S3: Amazon's static website hosting

🀝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

πŸ“Š Roadmap

Version 2.1.0 (Planned)

  • Real-time exchange rate API integration
  • Advanced filtering options
  • Custom date ranges
  • Transaction categories management

Version 2.2.0 (Future)

  • Backend integration options
  • Cloud data synchronization
  • Advanced analytics dashboard
  • Mobile app (PWA)

πŸ› Known Issues

  • Exchange rates are currently static (manual update only)
  • Large datasets (1000+ transactions) may experience slight performance degradation
  • Import functionality requires specific JSON format

πŸ“„ License

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

πŸ™ Acknowledgments

πŸ“ž Support


Made with ❀️ by AegisX-dev

Try it live: https://expense-tracker-one-wine.vercel.app/

About

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •