Loading repository data…

expenses_tracker

ProjectVault — a offline-first PWA for tracking expenses, income, debts, and recurring bills. Features monthly email statements, OTP-based password recovery, budget tracking, category breakdowns, and an installable mobile app experience. Built with vanilla HTML/CSS/JS, no backend required — all data stored locally on-device.

README preview

Expenses Tracker — by ProjectVault

A fast, offline-first Progressive Web App (PWA) for tracking expenses, income, debts, budgets, and recurring bills. No backend, no signup servers — everything runs in your browser and data stays on your device.

Features

💰 Track income & expenses by category, with visual breakdowns
🧾 Debt tracker — money you owe and money owed to you, with partial repayments
🎯 Monthly budget limits with progress tracking
🔁 Recurring bills and recurring income (e.g. salary), with reminders
📧 Automatic monthly email statements (income, expenses, daily/monthly averages)
🔑 Email-based OTP password recovery (find account by mobile number or email)
📲 Installable as a native-feeling app on Android/iOS/desktop (PWA)
🔒 Local biometric/device login support
🌙 Light & dark theme, mobile-first UI
🎉 Animated celebrations for cleared debts, budget wins, and savings milestones

Branding

"ProjectVault" is the umbrella brand (shown as "Powered by ProjectVault" on the login screen and in emails); Expenses Tracker is this specific app's name. Future apps under the same brand will each get their own name/logo while keeping the ProjectVault credit.

Tech stack

Plain HTML, CSS, and JavaScript — no framework, no build step. Data is stored in the browser's localStorage. Emails (statements + OTP) are sent client-side via EmailJS.

Getting started

Clone this repo
Open index.html directly in a browser, or serve it locally:
```
python3 -m http.server 8000
```
then visit http://localhost:8000
To enable real email delivery (monthly statements + OTP), follow EMAILJS_SETUP.md (~5 minutes, free tier available).

Deploying

Works great on any static host — GitHub Pages, Netlify, Vercel, etc. Just push the repo and point the host at the root folder; no build step required.

Project structure

index.html         Main app (markup, styles, and logic)
manifest.json       PWA manifest (name, icons, theme)
sw.js               Service worker (offline caching)
icon-192.png         App icon (192×192)
icon-512.png         App icon (512×512)
EMAILJS_SETUP.md     How to enable real email sending
GITHUB_MIGRATION.md  Notes on repo/account migration

Known limitations

This is a client-only app — there's no server, so monthly statements are checked/sent the next time the app is opened after month-end, not at the exact moment the month ends.
SMS OTP isn't supported (needs a paid gateway + backend); password recovery uses email OTP only.

License

MIT — see LICENSE.