Tally: expense tracker website

Log a spend in 3 seconds and always know what's safe to spend today. It's a mobile-first web app (PWA), so you can add it to your iPhone Home Screen, and it also works on Android and desktop.

• Account optional: without one, data stays in the browser (IndexedDB). Sign in with Google to sync phone and laptop through Supabase. No ads or tracking.
• Works offline after the first load: the service worker caches every file of a release.
• Updates in place: a new deploy downloads in the background and the app shows Update ready → Reload. Data is untouched.
• Stack: React 19, TypeScript, Vite, Supabase (auth + Postgres), one Vercel function. Plain CSS with light/dark themes.

Site map

Path	File	What it is
/	index.html + src/landing/	Public landing page with a live Smart add demo
/app	app.html + src/main.tsx	The app
/privacy	privacy.html	Privacy page
404	404.html	Not-found page

public/forward.js sends old app links that point at / (/?log=, /?capture=, #finances, Home Screen installs) on to /app.

Releases and offline support

sw/service-worker.js is a template. At build time, the plugin in vite.config.ts writes dist/sw.js with:

• a version hash of every output file, and
• the exact list of files to precache. The build fails if a listed file is missing.

A new release installs in the background and waits. src/data/updates.ts shows the Update ready bar, and Reload activates the new worker, which deletes the previous release's cache. If a release raises the IndexedDB version, open tabs on the old release close their connection and reload.

Data safety

• Restore (src/data/backup.ts) checks the whole file before changing anything:
  • It rejects non-Tally files, newer versions and rows with a broken amount or date.
  • It fills defaults for older backups.
• The restore is then written in one IndexedDB transaction, so it either fully happens or doesn't happen at all.
• The data it replaces is kept as a restore point. Swap it back in Settings puts it back, and is itself reversible.
• Home shows a reminder when there are 20+ expenses and no backup in 30 days.
• A crash shows a recovery screen with Reload and Download backup instead of a blank page.

Security headers

vercel.json sets a strict Content-Security-Policy, HSTS, X-Frame-Options: DENY, COOP, nosniff, no-referrer and a Permissions-Policy. The only third-party origin allowed is cdn.jsdelivr.net, for the receipt-OCR engine. vite preview serves the same headers, so CSP problems show up locally.

Features

• Home
  • Monthly spend vs budget, safe-to-spend today, and days left.
  • Swipe the dark card sideways to change month; tap it for the recap.
  • Pull down to search.
• One-tap repeats: tap to log. Long-press (or right-click) to log ±₹50, edit or remove.
• Swipe rows: left = Edit / Delete (a full swipe deletes, with a 5-second Undo). Right = Split / Repeat monthly.
• Quick add
  • Keypad.
  • Swipe the amount (or press ← →) to change category.
  • Swipe up on Save to log and keep going.
  • Drag the sheet handle down to close.
• Smart add
  • Type lunch 350 at chutneys, split with arjun, or several lines at once.
  • Receipt photo OCR runs in the browser with Tesseract (WebAssembly).
• Expense detail: edit everything, split N ways (only your share counts toward the budget), repeat monthly, exclude from budget.
• Home: safe to spend today (with the month drawn as tally marks), cash flow, what's due in 14 days, budgets, net worth and recent activity.
• Activity: every expense by month, as a list or calendar, filtered by category.
• Reports: cash flow for any period (where the money went, income vs spending by month, savings rate), spending grouped by category, place or payment method, filters, CSV export, and a month-in-detail view.
• Accounts: net worth over time from month-end balances, accounts grouped by type, and transfers between accounts.
• Plan: overall and category budgets; bills and subscriptions (due dates, price-rise flag, auto-log); repeating charges found in your spending (src/core/recurring.ts); savings goals.
• Inbox: captured payments wait for a one-tap confirm.
• Recap: month-end forecast, change vs the same point last month, biggest spend, no-spend days, logging streak.
• Regular income: salary and other monthly income add themselves on their day (Plan → Regular income, or "Repeats every month" on an income entry).
• Bank statement import: Settings → Import bank statement reads PDF, Excel or CSV statements from net banking (HDFC, ICICI, SBI, Axis and similar layouts), in the browser.
  • Withdrawals become expenses and deposits become income, with a category and a readable name for each.
  • Likely duplicates of hand-logged entries and transfers (card bills, own-account moves, SIPs) start unticked.

Log from iPhone Shortcuts (Action Button, Back Tap, Siri, Apple Pay)

Tally reacts to URL parameters:

This is the beginning of the README. Read the rest at the original. Read the full README ↗