Skip to content

OmarAglan/Budget-App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Budget Tracker - The Ultimate Personal Finance Management Tool

A cutting-edge, intelligent web application for comprehensive personal finance management. Transform your financial future with advanced budgeting, smart insights, and beautiful visualizations.

πŸš€ Key Features

πŸ’° Smart Budget Management

  • Intelligent Budget Setting with preset amounts and quick setup
  • Real-time Balance Tracking with visual progress indicators
  • Financial Health Score based on spending patterns and budget adherence
  • Category-wise Budget Allocation with spending limits and alerts
  • Predictive Budget Recommendations using AI-powered analysis

πŸ“Š Advanced Expense Tracking

  • Enhanced Categorization with 11 detailed categories and emoji icons
  • Quick Amount Buttons for faster expense entry
  • Floating Form Labels for modern, intuitive input experience
  • Smart Expense Validation with real-time feedback
  • Bulk Operations for managing multiple expenses efficiently

πŸ“ˆ Powerful Analytics & Visualizations

  • Interactive Dashboard with financial health scoring and insights
  • Enhanced Charts with modern styling and animations:
    • Dynamic pie/doughnut charts for category distribution
    • Gradient bar charts for spending trends
    • Category breakdown tables with detailed statistics
  • Period-based Analytics (today, week, month, year)
  • Smart Insights with personalized financial recommendations
  • Recent Activity Tracking with time-ago formatting

🎯 Advanced Features

  • Recurring Expenses (coming soon) - Automate regular payments
  • Savings Goals with progress tracking and deadline management
  • Monthly Reports - Generate detailed financial summaries
  • Spending Predictions based on historical data
  • Budget Alerts when approaching category limits

πŸ”§ Enhanced User Experience

  • Keyboard Shortcuts (Ctrl+B for budget, Ctrl+E for expenses, Esc to clear)
  • Advanced Search & Filtering with multiple criteria and sorting options
  • Auto-save Functionality to prevent data loss
  • Responsive Design optimized for all devices
  • Dark/Light Theme Support (coming soon)

πŸ“± Progressive Web App (PWA)

  • Installable App - Add to home screen on mobile/desktop
  • Offline Support - Works without internet connection
  • Push Notifications for budget alerts and reminders
  • App-like Experience with native feel and performance

πŸ”’ Privacy & Security

  • 100% Local Storage - Your data never leaves your device
  • No Registration Required - Start using immediately
  • Zero Data Collection - Complete privacy protection
  • Secure Data Export/Import with JSON format
  • Open Source - Transparent and trustworthy

πŸ›  Technologies Used

Frontend

  • HTML5 with semantic markup and accessibility features
  • CSS3 with modern features (Grid, Flexbox, Custom Properties, Animations)
  • JavaScript ES6+ with classes, modules, and modern APIs
  • Bootstrap 5 for responsive design and components

Visualization & Charts

  • Chart.js 4.x for interactive data visualizations
  • Custom SVG Graphics for progress rings and icons
  • CSS Animations for smooth micro-interactions

Progressive Web App

  • Service Worker for offline functionality and caching
  • Web App Manifest for installation and app-like experience
  • LocalStorage API for persistent data management
  • Push Notifications API for budget alerts

Design System

  • Inter Font Family for modern typography
  • Bootstrap Icons for comprehensive icon library
  • Custom CSS Variables for consistent theming
  • Responsive Grid System for all device sizes

πŸš€ Getting Started

Quick Start (No Installation Required)

  1. Clone this repository

    git clone https://github.com/username/budget-tracker.git
    cd budget-tracker
  2. Open in your browser

    # Simply open index.html in any modern web browser
    open index.html  # macOS
    start index.html # Windows
    xdg-open index.html # Linux
  3. Start budgeting immediately - No setup, no configuration needed!

Development Setup

# For development with live server
npm install -g live-server
live-server --port=3000

PWA Installation

  • Desktop: Click the install button in your browser's address bar
  • Mobile: Use "Add to Home Screen" from your browser menu
  • Automatic: The app will prompt you to install after a few visits

πŸ“– Usage Guide

🎯 Dashboard Overview

  • Financial Health Score: Monitor your overall financial wellness with a visual score
  • Quick Stats: View today, week, month, and average daily spending at a glance
  • Smart Insights: Get personalized recommendations based on your spending patterns
  • Recent Activity: Track your latest transactions with timestamps

πŸ’³ Budget Management

  1. Set Your Budget: Use the enhanced budget form with preset amounts ($1,000, $2,500)
  2. Monitor Progress: Real-time progress bar and percentage indicators
  3. Visual Feedback: Color-coded balance display (green=good, yellow=warning, red=over budget)

πŸ’Έ Expense Tracking

  1. Add Expenses: Modern floating labels with 11 detailed categories
  2. Quick Entry: Use quick amount buttons ($5, $10, $25, $50, $100)
  3. Smart Categorization: Emoji-enhanced categories for better visual organization
  4. Bulk Management: Select and manage multiple expenses at once

πŸ“Š Analytics & Insights

  • Interactive Charts: Switch between pie and doughnut chart views
  • Trend Analysis: Customizable time periods (7, 30, 90 days)
  • Category Breakdown: Detailed table with percentages and averages
  • Spending Predictions: AI-powered forecasting for future expenses

πŸ” Advanced Search & Filtering

  • Multi-criteria Search: Text, category, and date range filtering
  • Smart Sorting: Sort by date, amount, or category
  • Active Filter Display: Visual badges showing current filters
  • Quick Reset: One-click filter clearing

πŸ“± Mobile & PWA Features

  • Install as App: Add to home screen for native app experience
  • Offline Support: Works without internet connection
  • Responsive Design: Optimized for all screen sizes
  • Touch Gestures: Swipe and tap interactions

⌨️ Keyboard Shortcuts

  • Ctrl+B: Focus on budget input
  • Ctrl+E: Focus on expense input
  • Esc: Clear current form
  • Tab: Navigate between form fields
  • Enter: Submit current form

πŸ’Ύ Data Management

  • Auto-save: Automatic data persistence as you type
  • Export/Import: JSON format for data portability
  • Monthly Reports: Generate Markdown reports with detailed analytics
  • Data Clearing: Bulk delete with confirmation

🎨 Design Philosophy

Built with modern design principles:

  • Minimalist Interface - Clean, distraction-free design
  • Intuitive Navigation - Logical flow and clear hierarchy
  • Visual Feedback - Immediate response to user actions
  • Accessibility First - WCAG compliant with keyboard navigation
  • Performance Optimized - Fast loading and smooth animations

πŸ”§ Advanced Configuration

Custom Categories

Add your own expense categories by modifying the category list in the expense form.

Budget Periods

The app supports flexible budget periods - set monthly, weekly, or custom timeframes.

Data Backup

Regular exports recommended for data safety. The app generates timestamped backup files.

🀝 Contributing

We welcome contributions! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow existing code style and patterns
  • Add comments for complex functionality
  • Test on multiple browsers and devices
  • Update documentation for new features

πŸ“„ License

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

🌟 Live Demo

Try Budget Tracker Now β†’


Made with ❀️ for better financial wellness

About

A modern web-based application for tracking and managing personal finances

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •