💳 EMI & Expense Tracker

Know exactly how much you must pay every month — nothing more, nothing less.

📋 TL;DR

Privacy-first, 100% offline expense tracker. No accounts, no cloud. Track EMIs, subscriptions, recurring payments with flexible frequencies (monthly, quarterly, half-yearly, yearly, custom). Auto-archives completed items. Seal Mode locks payments for financial certainty. Freedom Timeline shows your debt-free date. PWA, open source, free.

Try it Now →

🎯 Why This Exists

Built for people who want to track their finances without:
❌ Creating accounts
❌ Uploading data to someone's server
❌ Paying subscription fees
❌ Trusting "AI insights" with their money

If you want a simple, transparent tool that calculates what matters and stays out of your way, this is it.

❗ The Problem This Solves (Real & Personal)

I wanted one simple number that tells me:

"This is the amount I must pay every month (for example: $4000).
Spend whatever is left — freely."

I don't track salary because salary changes.
What doesn't change are constant spendings:

EMIs
Loans
Rent
Netflix / Spotify
Insurance
Subscriptions

I was tired of:

Re-adding the same expenses every month (or quarter/year)
Remembering which EMIs are still active
Manually excluding EMIs after they end
Tracking which payments I've already made this month/cycle
Converting quarterly/yearly expenses to "monthly equivalents" (confusing!)
Accidentally unchecking payments or changing status after I've confirmed everything
Doubting myself: "Did I really pay this? Should I double-check?"
The anxiety of accidental touches messing up my payment tracking

Once an EMI ends, it should automatically stop affecting my monthly total.

That's it.
That's the core problem.

✨ What It Does (Overview)

EMI & Expense Tracker

A simple, privacy-first, offline Progressive Web App that:

Tracks expenses with flexible payment frequencies (monthly, quarterly, half-yearly, yearly, custom)
Automatically excludes EMIs after their end date
Shows one clear number:

Total mandatory monthly payment
🔄 Periodic Payment Tracking — Manage non-monthly expenses separately
🎯 Financial Freedom Timeline — See exactly when you'll be debt-free
Works 100% offline
Requires zero sign-up
Stores data only on your device

Simple. Private. Yours.

A lightweight, privacy-first Progressive Web App for tracking EMIs, loans, and recurring expenses — 100% offline, 100% yours.

Try it Now →

🎯 How It Works

Add Your Items — EMIs, loans, rent, subscriptions, savings goals with flexible frequencies
Choose Frequency — Monthly, quarterly, half-yearly, yearly, or custom intervals
Mark as Paid — Check off items as you pay them throughout the month/cycle
🔒 Seal Payments — Lock checked items to prevent accidental changes
Auto-Reset — Payment status automatically resets each month or cycle
Get Celebrated — Complete all payments? We'll celebrate with you! 🎉
Auto-Archive — Completed EMIs automatically move to archive
Track Your Freedom — Financial Freedom Timeline shows when you'll be debt-free
Manage Periodic Payments — Separate view for quarterly, half-yearly, yearly expenses

🚀 Quick Start

Option 1: Use It Now (Web App)

Visit: https://dhuruvandb.github.io/EMI-And-Expense-calculator/
Click "Install App" button (optional)
Start tracking!

Option 2: Self-Host

git clone https://github.com/dhuruvandb/EMI-And-Expense-calculator.git
# Open index.html in any browser — that's it!

Option 3: Embed in Android Apps

WebView webView = findViewById(R.id.webView);
webView.getSettings().setJavaScriptEnabled(true);
webView.getSettings().setDomStorageEnabled(true);
webView.loadUrl("file:///android_asset/index.html");

🛠️ Built With & Technical Details

Technology Stack

Vanilla JavaScript (Zero dependencies, no frameworks)
Progressive Web App (PWA) technology (installable, works offline)
LocalStorage API (100% offline operation, your data stays on your device)
Modern Web APIs (100% client-side, no backend required)

Technical Specifications

Frontend: Vanilla HTML5 + CSS3 + JavaScript (no frameworks)
Storage: Browser localStorage API (3 separate keys for active/archived/preferences)
Size: ~60KB total (HTML + CSS + JS combined)
Dependencies: Zero — Pure vanilla JavaScript

Browser Support

Browser	Minimum Version
Chrome/Edge	60+
Safari	12+
Firefox	60+
Android WebView	60+

Performance

⚡ Loads in <100ms
🪶 Lightweight codebase
📱 Works on 2G networks
🔄 Auto-refresh every minute for monthly reset detection

📋 Detailed Features Breakdown

Core Features

✅ Track unlimited EMIs, loans, and recurring expenses
✅ Flexible payment frequencies — Monthly, quarterly, half-yearly, yearly, custom intervals
✅ 3-tab view system — Monthly, Periodic, and Archive views
✅ Monthly payment tracking — Check off items as you pay them
✅ Periodic payment tracking — Separate cycle-based tracking for non-monthly expenses
✅ 🔒 Seal Mode — Lock your payments to prevent accidental changes
✅ 🎯 Financial Freedom Timeline — See your debt-free date and countdown
✅ Auto-archive system — Completed EMIs automatically move to archive
✅ Smart search — Instant search by name or amount
✅ Works 100% offline after first load
✅ Export/Import your data (JSON backup with archive support)
✅ Dark mode for late-night budgeting
✅ Install as native app (PWA)
✅ Auto-save — never lose your data
✅ 8 sorting options + 4 grouping modes

🔒 Seal Mode — Financial Peace Ritual

The Problem: You've checked all your payments. But later, you accidentally tap a checkbox, or you start doubting yourself: "Did I really pay this?" The anxiety builds.

Seal Mode solves this with a deliberate ceremony:

✅ Lock Your Payments — Seal checked items to prevent accidental changes
✅ 8-Second Ceremony — 3s countdown + 5s undo period ensures intentional commitment
✅ Multiple Seals Per Month — Seal items as you pay them, add new expenses, seal again
✅ Visual Lock Icons — 🔒 Sealed items show lock instead of checkbox
✅ Smart Messages:
- Seal 1 item: "🔒 Sealed! Forget "Rent" this month"
- Seal all items: "💚 Fully paid up! Financial peace of mind!"
✅ Full Protection — Cannot edit, delete, or uncheck sealed items until next month
✅ Auto-Unlock — Seals automatically clear on the 1st of next month
✅ Export/Import Aware — Seal state preserved when exporting/importing same month

How Seal Mode Works:

Check off your payments ✓
Click "🔒 Seal" button
Confirm in modal
3-second countdown — Press STOP to abort
5-second undo period — Press UNDO to reverse
Done! Items locked until next month 🎉

🎯 Payment Status Tracking

Check off items as you pay them each month
Automatic monthly reset (payment status clears at month start)
Visual strikethrough for paid items
Smart calculation excludes paid items from monthly total

� Periodic Payment Tracking — Beyond Monthly

The Problem: Not all expenses are monthly. Insurance premiums, property taxes, annual subscriptions, quarterly maintenance — real life has varied payment schedules.

Periodic Payment Tracking gives you flexibility without complexity:

✅ 5 Frequency Options:
- Monthly — Traditional monthly tracking (default)
- Quarterly — Every 3 months (e.g., property tax, quarterly insurance)
- Half-Yearly — Every 6 months (e.g., car insurance, semi-annual fees)
- Yearly — Annual payments (e.g., domain renewals, memberships)
- Custom — Any interval in days or months (e.g., every 45 days, every 2.5 months)
✅ Separate Periodic View — 3-tab system: Monthly | Periodic | Archive
✅ Cycle-Based Tracking — Each periodic item tracks its own payment cycle
✅ Next Due Date Calculation — Automatically calculates when payment is due next
✅ Smart Due Status:
- Due Now — Payment is currently due (highlighted)
- Paid This Cycle — Payment completed for current cycle
- Upcoming — Not yet due
✅ Visual Frequency Badges — See at a glance: "Every 3 months", "Yearly", "Every 45 days"
✅ Frequency Filtering — Filter periodic view by frequency type
✅ Separate Totals — Periodic payments don't clutter your monthly budget

How Periodic Payments Work:

Add Item — Choose payment frequency (e.g., "Quarterly")
Set Cycle Start Date — When did this cycle begin? (e.g., Jan 1, 2026)
See Next Due Date — App calculates: "Next due: Apr 1, 2026"
Track Payment — When due date arrives, item shows in "Due Now" section
Mark as Paid — Check it off, moves to "Paid This Cycle"
Auto-Reset — On next due date, payment status resets automatically
Separate View — Switch to Periodic tab to see all non-monthly items

Real-World Examples:

Car Insurance — Half-yearly, cycle starts Jun 1 → Next due: Dec 1
Property Tax — Quarterly, cycle starts Jan 1 → Next due: Apr 1
Domain Renewal — Yearly, cycle starts Mar 15 → Next due: Mar 15, 2027
Maintenance Fee — Custom (every 45 days), cycle starts Feb 1 → Next due: Mar 18

Why This Matters:

Instead of manually converting quarterly payments to "monthly equivalent" (confusing and inaccurate), track them naturally. See exactly when they're due, pay them, forget them until next cycle.

Smart Integration:

Monthly view shows only monthly items (clean, focused)
Periodic view shows only non-monthly items (organized by due status)
Archive view shows completed EMIs (regardless of frequency)
Export/Import preserves all frequency settings and cycle states

�🗃️ Intelligent Archive Management

Completed EMIs automatically archive when end date passes
Separate archive view to review past items
Archive items included in export/import backups
Clean interface showing only active items

📊 Category Separation

Loan/Debt tracking — EMIs, loans, credit cards
Savings tracking — SIPs, RDs, investment commitments
Separate totals for debt vs savings in dashboard
Color-coded rows (red for debt, green for savings)

🔓 Financial Freedom Timeline — Hope, Not Just Burden

The Problem: You know what you owe, but when will it end? Most trackers focus on debt burden, not liberation.

Freedom Timeline shows you the light at the end of the tunnel:

🎯 See Your Debt-Free Date — Exact date when your last EMI ends
⏰ Countdown Timer — Years, months, or days until financial freedom
📅 Upcoming Milestones — Next EMIs ending with payment relief amounts
💚 Motivational Focus — Track progress toward freedom, not just obligations
🔄 Auto-Updates — Timeline adjusts as you add, edit, or complete EMIs
📊 Click for Details — Modal view with full milestone breakdown

How It Works:

Add EMIs with end dates (e.g., Car Loan ends Dec 2028)
Freedom Timeline card appears in dashboard
Shows your debt-free date with glowing countdown badge
Click the card to see detailed milestones and timeline
Watch the countdown decrease as time passes
Celebrate when you reach freedom! 🎉

Visual Design:

Beautiful green gradient card in dashboard
Animated shimmer effect for visual appeal
Glowing countdown badge that pulses
Clean modal with full milestone list
Dark mode support with enhanced glows

Smart Logic:

Only shows when you have active EMIs with end dates
Filters out savings and ongoing expenses
Automatically hides when last EMI completes
Calculates freedom date from latest EMI end date
Updates in real-time as you manage items

🎉 Celebration Mode

Get rewarded when all monthly payments are complete!
Encouraging messages for savings contributions
"Financial peace of mind" celebration toast

🔍 Smart Search & Organization

Instant search by name or amount (300ms debounce)
8 Sort Options: Entry order, due date, amount, end date, period left, name, type, category
4 Grouping Modes: Category, type, due date range, status
Bidirectional sorting (ascending/descending)
Group totals displayed in headers

📊 Real-Time Dashboard

📊 Total active items count
💰 Monthly payment breakdown (Debt + Savings)
💳 Outstanding debt tracker (principal remaining)
🎯 Debt-Free Date & Countdown (when you have active EMIs)
🚨 Color-coded period alerts:
- 🟢 Normal (≤30 days remaining)
- 🟡 Warning (31-90 days)
- 🔴 Critical (>90 days)

🔒 Privacy by Design

🔒 No backend servers — your data never leaves your device
🔒 No user accounts — nothing to sign up for
🔒 No tracking — zero analytics, cookies, or pixels
🔒 100% client-side — auditable source code

⚠️ **Important: What This App Is Not For**

Please don't use this app if you are looking for:

Daily expense tracking
Per-transaction budgeting
Categorizing every coffee or grocery purchase
Push notifications (we intentionally don't have them — see FAQ)

👉 This app is NOT built for daily budgeting.

It is designed only for:

Fixed recurring expenses (monthly, quarterly, half-yearly, yearly, custom)
EMIs with clear end dates
Knowing your mandatory payment obligations — fast and reliably

🔒 Privacy & Data Ownership

Where Your Data Lives

Your data is stored only in your browser's localStorage:

✅ Remains on YOUR device
✅ Not transmitted anywhere
✅ Not accessible by anyone else
✅ You control export/delete

What We DON'T Collect

❌ Names, emails, phone numbers
❌ Financial data
❌ IP addresses or location
❌ Analytics or tracking data
❌ Literally nothing

Open Source = Verifiable

Every line of code is open for inspection. No hidden trackers, no backdoors.

💾 Backup Your Data

Export (Recommended)

Click "📥 Export" button in header
Saves as emi-tracker-backup-YYYY-MM-DD.json
Includes active items (monthly & periodic), archived items, and preferences
Store in cloud (Google Drive, Dropbox, etc.)

Import

Click "📤 Import" button
Select your .json file
Choose to merge with existing data or replace
Handles both old format (array) and new format (active/archived split)
Preserves payment frequencies and cycle states
Auto-archives completed items during import

⚠️ Important: Browser cache clears can delete data. Export regularly!

❓ FAQ

Q: What happens to my data if I clear browser cache?

A: Your data will be lost forever. Always export your data regularly to avoid losing it. Store backups in cloud storage or email them to yourself.

Q: Can I access my data on multiple devices?

A: Yes! Export from one device, then import to another. The app works entirely offline, so data doesn't sync automatically.

Q: How does auto-archive work?

A: When an EMI's end date passes, it automatically moves to the archive on next app load. You can view archived items by clicking "📦 View Archive".

Q: What's the difference between EMI and Constant Expense?

A: EMI has a fixed end date (like a car loan ending in 2027). Constant Expense is ongoing with no end date (like rent or Netflix).

Q: What are periodic payments and how do they work?

A: Periodic payments are expenses that occur at intervals other than monthly — like quarterly insurance, half-yearly property tax, or yearly subscriptions. Instead of tracking them as "monthly equivalent," you track them naturally:

Choose frequency: Quarterly, Half-Yearly, Yearly, or Custom
Set cycle start date (when the payment cycle began)
App calculates next due date automatically
Payment appears in "Due Now" when it's time to pay
Mark as paid, and it moves to "Paid This Cycle"
On the next due date, it resets automatically

This keeps your monthly view clean while tracking non-monthly expenses accurately.

Q: What's the difference between Monthly and Periodic views?

A: The app has a 3-tab view system:

📅 Monthly — Shows only items with monthly payment frequency
🔄 Periodic — Shows only items with quarterly, half-yearly, yearly, or custom frequencies
📦 Archive — Shows completed EMIs (all frequencies)

This separation keeps each view focused and clutter-free. Your monthly budget only shows monthly items, while periodic items are managed separately by their own cycles.

Q: Can I use custom payment frequencies?

A: Yes! The Custom frequency option lets you set any interval in days or months. Examples:

Every 45 days
Every 2.5 months
Every 90 days
Every 1.5 months

Just select "Custom", enter the number, and choose "days" or "months" as the unit.

Q: How does payment tracking work for periodic items?

A: Periodic items use cycle-based tracking instead of monthly tracking:

When a periodic item's due date arrives, it shows in "Due Now"
You mark it as paid, and it moves to "Paid This Cycle"
The payment status stays "paid" until the next due date arrives
Then it automatically resets and becomes due again

This is different from monthly items, which reset every calendar month.

Q: What happens to payment tracking each month?

A: All payment checkboxes automatically reset at the start of each month. This ensures you track payments fresh every month.

Q: How does the celebration mode work?

A: When you mark all active items as paid for the month, you'll see a special celebration message: "Financial peace of mind" 🎉

Q: What is Seal Mode and why should I use it?

A: Seal Mode locks your checked payments to prevent accidental changes. Once you've confirmed all payments are done, seal them to achieve mental peace. You won't accidentally uncheck something or doubt whether you paid. Sealed items show a 🔒 lock icon and cannot be edited, deleted, or unchecked until next month.

Q: How does the 8-second ceremony work?

A: When you click "Seal", you get:

3-second countdown with a STOP button (last chance to abort)
5-second undo period with an UNDO button (final safety net)
After 8 seconds total, items are permanently sealed for the month This deliberate process ensures you're intentional about sealing.

Q: Can I seal items multiple times in one month?

A: Yes! Seal items as you pay them. For example:

Day 5: Pay rent, seal it → "🔒 Sealed! Forget Rent this month"
Day 10: Pay Netflix, seal it → Adds to sealed list
Day 20: Pay all remaining → "💚 Fully paid up! Financial peace!"

Q: What happens to sealed items when exported/imported?

A: If you export and import in the same month, seal status is preserved. If you import in a different month, everything resets automatically with a notification: "📅 Month changed! Data imported with payments and seal reset for new entries"

Q: Can I edit or delete a sealed item?

A: No. Sealed items are locked until the 1st of next month. This is intentional — it prevents accidental changes and gives you peace of mind that your payment tracking is final.

Q: Can I track savings separately from debts?

A: Yes! When adding items, choose Savings category. The dashboard shows separate totals for debt vs savings.

Q: How does the Freedom Timeline work?

A: The Freedom Timeline automatically appears in your dashboard when you have active EMIs with end dates. It shows:

Your exact debt-free date (when your last EMI ends)
Countdown timer (years/months/days until freedom)
Next 5 upcoming milestones (EMIs ending soon)
Click the card to see full details in a modal

The timeline only tracks debt/expense items (not savings) and automatically updates as you add, edit, or complete EMIs. It disappears when you have no more active EMIs.

Q: How secure is my financial data?

A: Completely secure. Your data never leaves your device. No server, no cloud, no transmission. It's 100% local storage.

Q: ❓ Why doesn't this app have push notifications?

A: Great question — and we made this decision intentionally.

Push notifications on the web require ONE of two things:

Keep the app constantly active → Battery drain, memory hogging, always listening
Connect to a backend server → Your financial data gets stored on someone's server, sent over the internet, synced across devices

Both options destroy the privacy we built this app around.

We refused to compromise.

The Trade-Off We Chose:

✅ You check the app when YOU want
✅ No background processes stalking your device
✅ No financial data ever leaving your phone
✅ No battery drain from constant monitoring
✅ No "reminder anxiety" from notifications pestering you

The Reality:

Your EMI tracker is simple enough that a 30-second check every few days tells you everything:

What's due this month?
What's already paid?
Any new items to add?

You don't need the app spamming your notifications to stay on top of it.

This Is Actually a Feature:

In a world where apps are constantly fighting for your attention, this app respects your focus. You're in control. No notifications. No pressure. Just open it when you decide.

The Wisdom Here:

We could have added notifications by:

Storing your data on our servers ❌
Adding a backend API ❌
Selling you "premium notification features" ❌

Instead, we chose to keep your data 100% private, even if it meant saying "no" to a feature users expect.

That's the trade-off between convenience and privacy. We picked privacy. 🔒

🆚 Why Choose This Over Other Apps?

Feature	Other Apps	EMI Tracker
Requires Account	✅ Yes	❌ No
Cloud Sync Required	✅ Yes	❌ No
Works Offline	❌ No	✅ Yes
Monthly Payment Tracking	Sometimes	✅ Yes
Periodic Payment Frequencies	❌ No	✅ Yes
Custom Intervals	❌ No	✅ Yes
Seal Mode (Lock Status)	❌ No	✅ Yes
Freedom Timeline	❌ No	✅ Yes
Auto-Archive Completed	❌ No	✅ Yes
Auto-Reset Monthly	❌ No	✅ Yes
Push Notifications	✅ Yes	❌ No
Privacy First	❌ No	✅ Yes
100% Free	❌ No	✅ Yes
Zero Dependencies	❌ No	✅ Yes
Open Source	❌ No	✅ Yes

🎨 Screenshots

Dashboard	Add Item	Dark Mode

👤 User Journey

Day 1: Add all your EMIs and recurring expenses (home loan, car EMI, rent, Netflix)
Day 1: Add quarterly car insurance to Periodic view (₹20,000 every 3 months)
Day 1: 🎯 Freedom Timeline appears — "Debt-Free: Dec 15, 2028 • 2y 11m away"
Day 5: Mark "Home Loan" as paid ✓ — monthly total updates automatically
Day 6: Seal "Home Loan" 🔒 — Now it's locked, no accidental unchecking
Day 10: Mark "Car EMI" as paid ✓, seal it 🔒
Day 15: All items paid! Seal remaining → 🎉 "Financial peace of mind!"
Day 20: Try to edit sealed item → Blocked with message "🔒 Cannot edit sealed payments"
Next Month (1st): All seals auto-unlock, payment status resets, start fresh
3 Months Later: Car insurance shows "Due Now" in Periodic view → Pay it, mark as paid
6 Months Later: Car EMI completed → Auto-archived, Freedom Timeline updates to new date
1 Year Later: Export backup (includes monthly, periodic, archived items), import to new device
2 Years Later: Click Freedom Timeline → See "6 months away!" → Motivation boost 🚀

🚀 Roadmap (Completed ✅)

🤝 How to Help

⭐ Star this repo — helps others discover it
📢 Share — tell privacy-conscious friends

Development

git clone https://github.com/dhuruvandb/EMI-And-Expense-calculator.git
# Edit files — no build process needed
# Open index.html in browser to test

📄 License

MIT License — Free to use, modify, and distribute.

Copyright (c) 2024 Dhuruvan

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software...  [full license](LICENSE)

🎖️ Acknowledgments

Inspired by:

Privacy-first software movement
Progressive Web App best practices
Open source community
Real frustrations with overcomplicated finance apps

Made for Privacy-Conscious Users

No subscriptions. No data collection. No BS.
Your finances. Your data. Your control.

Try It Now →

If this helps you, give it a ⭐.

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
.github		.github
LICENSE		LICENSE
README.md		README.md
icon-192.png		icon-192.png
icon-512.png		icon-512.png
index.css		index.css
index.html		index.html
manifest.json		manifest.json
script.js		script.js
sw.js		sw.js

Uh oh!

Folders and files

Latest commit

History

Repository files navigation