Skip to content

mrnavsingh/offlineexpensetracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’° Offline Expense Tracker

A privacy-focused, open-source expense tracking application that runs entirely in your browser. No servers, no accounts, no data collection - just pure, secure expense management.

License: MIT HTML5 JavaScript CSS3

🌟 Features

πŸ”’ Complete Privacy

  • 100% Client-Side: All data processing happens in your browser
  • No Server Storage: Your financial data never leaves your device
  • No Account Required: Start tracking expenses immediately
  • No Internet Required: Works offline after initial load
  • Open Source: Fully transparent, inspectable code

πŸ“Š Powerful Analytics

  • Visual Charts: Pie charts, bar graphs, and trend lines for expense analysis
  • Category Breakdown: See where your money goes with detailed categorization
  • Monthly/Daily Trends: Track spending patterns over time
  • Top Expenses: Identify your biggest spending areas
  • Comparison Tools: Compare spending across different time periods

πŸ’Ύ Data Management

  • Export to CSV: Compatible with Excel, Google Sheets, and other spreadsheet software
  • Export to JSON: Perfect for backups and data portability
  • Import Functionality: Restore backups or migrate data easily
  • Inline Editing: Click any expense to edit it directly
  • Bulk Operations: Select and manage multiple expenses at once

⏰ Smart Reminders

  • Customizable Alerts: Set reminders to log expenses regularly
  • Backup Reminders: Never forget to backup your data
  • Flexible Scheduling: Choose specific days and times
  • Audio/Visual Notifications: Stay on track with your expense logging

🎨 User Experience

  • Clean, Modern Interface: Intuitive design that's easy to navigate
  • Responsive Design: Works perfectly on desktop, tablet, and mobile
  • Keyboard Shortcuts: Power user features for efficiency
  • Dark/Light Themes: (Coming soon)
  • Multiple Currency Support: (Coming soon)

πŸš€ Quick Start

Option 1: Use Online

Visit https://offlineexpensetracker.com to start using the app immediately.

Option 2: Run Locally

  1. Clone this repository:
    git clone https://github.com/mrnavsingh/offlineexpensetracker.git
  2. Open index.html in your web browser
  3. Start tracking your expenses!

Option 3: Download and Run Offline

  1. Download the repository as a ZIP file
  2. Extract the files to your computer
  3. Open index.html in any modern web browser
  4. The app will work completely offline

πŸ“– How to Use

Adding Expenses

  1. Enter the date (defaults to today)
  2. Add a description (e.g., "Grocery shopping")
  3. Select or create a category
  4. Enter the amount
  5. Click "Add Expense"

Managing Categories

  • Click "Manage Categories" to add, edit, or delete expense categories
  • Categories help you organize and analyze your spending patterns

Viewing Analytics

  • Switch to the "Stats" tab to see visual representations of your spending
  • View charts by category, time period, and spending trends
  • Identify areas where you can save money

Setting Reminders

  • Go to the "Settings" tab
  • Configure expense entry reminders (e.g., every 3 hours)
  • Set backup reminders (daily, weekly, or monthly)
  • Choose active days and times

Exporting Data

  • Click "Export to CSV" for spreadsheet-compatible files
  • Click "Export to JSON" for complete backups including settings
  • Save exports regularly to prevent data loss

πŸ›‘οΈ Privacy & Security

Your Data is Yours

  • No Servers: We don't have servers to store your data
  • No Tracking: No analytics, cookies, or user tracking
  • No Network Requests: After loading, the app makes no external connections
  • Local Storage Only: Data is stored in your browser's localStorage
  • Encrypted Storage: Data is stored securely on your device

Security Best Practices

  • Export and backup your data regularly
  • Clear browser data only after creating backups
  • Use the app on trusted devices
  • Keep your browser updated for the latest security features

πŸ› οΈ Technical Details

Technologies Used

  • HTML5: Structure and semantic markup
  • CSS3: Responsive styling and animations
  • Vanilla JavaScript: No framework dependencies
  • Chart.js: Beautiful, responsive charts
  • localStorage API: Secure client-side data storage

Browser Compatibility

  • βœ… Chrome 60+
  • βœ… Firefox 55+
  • βœ… Safari 11+
  • βœ… Edge 79+
  • βœ… Opera 47+
  • βœ… Mobile browsers (iOS Safari, Chrome Mobile)

File Structure

offline-expense-tracker/
β”œβ”€β”€ index.html          # Main application file
β”œβ”€β”€ styles.css          # Application styling
β”œβ”€β”€ script.js           # Application logic
β”œβ”€β”€ LICENSE            # MIT license file
└── README.md          # This file

🀝 Contributing

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

  1. Fork the Repository: Click the 'Fork' button at the top right
  2. Clone Your Fork:
    git clone https://github.com/mrnavsingh/offlineexpensetracker.git
  3. Create a Branch:
    git checkout -b feature/your-feature-name
  4. Make Changes: Implement your feature or fix
  5. Test Thoroughly: Ensure all features work correctly
  6. Commit Changes:
    git commit -m "Add: your feature description"
  7. Push to GitHub:
    git push origin feature/your-feature-name
  8. Open a Pull Request: Describe your changes and submit

Development Guidelines

  • Keep the app 100% client-side (no server dependencies)
  • Maintain backward compatibility with existing data
  • Follow the existing code style
  • Add comments for complex logic
  • Test on multiple browsers
  • Update documentation as needed

πŸ“‹ Roadmap

Upcoming Features

  • Dark mode theme
  • Multiple currency support
  • Recurring expense tracking
  • Budget goals and limits
  • Receipt photo attachments (local storage)
  • Advanced filtering options
  • Custom report generation
  • Multi-language support
  • PWA (Progressive Web App) support
  • Expense tags/labels

πŸ› Bug Reports

Found a bug? Please open an issue with:

  • Browser version and OS
  • Steps to reproduce the bug
  • Expected vs actual behavior
  • Screenshots if applicable

πŸ“„ License

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

πŸ™ Acknowledgments

  • Chart.js for beautiful charts
  • The open-source community for inspiration
  • All contributors who help improve this project

πŸ“ž Support

  • Documentation: Check this README and code comments
  • Issues: Open an issue for bugs or feature requests
  • Discussions: Use GitHub Discussions for questions
  • Email: [support@offlineexpensetracker.com]

🌐 Links


Made with ❀️ for privacy-conscious individuals

No servers. No tracking. No worries.

About

Offline Expense Tracker

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors