Filters
📥 Card alerts
Charges from Capital One alert emails land here first. Accept one to add it as a pending transaction — it confirms automatically when the statement is imported, so nothing double-counts.
Import from CSV file
Export transactions from your bank as CSV, then map its columns below.
Import from PDF statement
Wells Fargo, Citibank, and Capital One statements are parsed right in your browser. With Firebase storage, the original file is also kept privately so you can reopen it from the import log later. You can also drag a PDF onto this card.
Import preview
Categories are auto-guessed — auto · high is confident, auto · med deserves a glance, no guess needs your pick. Nothing is forced: rows without a category import as Uncategorized.
| Date | Merchant / Payee | Amount | Type | Account | Category | Pay method |
|---|
Imported statements
Everything you've imported is logged here — check it before pulling new statements from your bank.
Income planner
Budget planner
Bills due
Upcoming bills
Paid
Expected income
Payments you expect to receive — track what shows up and follow up on what doesn't.
Prints a summary for your CPA — category totals only. Save as PDF in the print dialog; the CSVs below carry transaction detail.
Business — Schedule C
Business income
Personal deductions
Personal income
Note: deductible business meals are generally only 50% deductible. Amounts above are shown in full — apply the 50% limit on your return.
Loading...
Expense report
Tip: tap any chart to see the underlying transactions.
Category Mix
Share of total spend
Category Bars
Each month's spend by category, side by side — tap a bar to drill in
Category Mix table
Income and expenses by category
Budget vs Actual
Budgeted vs spent by category for the selected period
Budget vs Actual table
Budget, actual, variance, and % of budget by category
Monthly Trend
Spend and cumulative total by month
Top Merchants
Largest merchants by spend
Weekday Pattern
Spend by day of week
Largest expenses
Income by category
Transaction Size Bands
Count of expenses by amount range
Owner Split
Spend by who entered the transaction
Spend by (Spent by)
Spend by who the money was for — tap a slice to drill in
Card Split
Spend by bank / payment method
Category Volume
Transaction count by category — tap a bar to drill in
Average Ticket
Average expense amount by category — tap a bar to drill in
Category Spend Trend
Monthly spend stacked by top categories — tap a segment to drill in
Spent by Trend
Monthly spend stacked by Spent by — tap a segment to drill in
Owner vs Category
Top categories compared by owner — tap a bar to drill in
Spent by vs Category
Top categories compared by Spent by — tap a bar to drill in
Spent by across Categories
Filtered categories compared for every Spent by name — tap a bar to drill in
Spent by stacked by Category
One bar per category with Spent by segments stacked — tap a segment to drill in
Spend Pareto
Cumulative share of spend by category (80/20) — tap a bar to drill in
Category × Month Heatmap
Spend intensity by category and month — tap a cell to drill in
Internal account movements (brokerage, savings, line-of-credit, transfers) are grouped as “Transfers” for display only — your sheet categories are unchanged.
Data store and username
Who's entering?
You’ll be redirected to sign in, then back here. Linking keeps this machine’s data.
You’re on No password for this machine. Pick another option above only if you want to sync across devices.
Scheduled folder backup needs a standalone Chromium browser (Chrome, Edge, or Brave) with the File System Access API. It is not available in Safari, Firefox, or Cursor’s built-in browser (Electron exposes the picker but aborts after Select with no folder handle). Use Download backup (JSON) above anytime — that works everywhere. For local folder backup, open this page in Chrome at http://localhost:8765.
No folder selected — use Choose folder…
While enabled, the app checks on load, when you return to this tab, and about every 15 minutes. Backups only run while this tab is open — closing the browser completely pauses scheduled backups until you open the app again. Files are named like expense-tracker-backup-YYYY-MM-DD.json (same JSON as Download backup). If a file for today already exists, it is replaced.
Data cleanup
Older PDF imports sometimes glued statement text onto merchant names — section headers (like "JANE DOE #1234: Transactions"), debit-card prefixes (like "Purchase authorized on 08/15 …") or fine print (like "Important Information You Should Know …"). Scan finds those rows so you can review and fix them — with undo.
Switching storage only changes where new reads and writes go — the data in the other location stays untouched until you copy it over.
Security
Optional password for this computer only. It encrypts the data stored here. It is not the Firebase sign-in, and it is not required to use Money Buddy.
Forgetting this password means this computer cannot open your data. Download a JSON backup first if you want a way back.
A password is on. Opening Money Buddy on this computer will ask for it. The key is forgotten when you close the tab.
Default App Settings
Initialization: what the app does on startup with a fresh data file. Page choices here apply the first time there is no saved tab layout. After that, the Tab bar card controls which pages show on this device.
An Apple-style What’s New sheet: a short title and a few points. Each page shows its card once.
Puts sort orders, columns, and card positions back to the defaults in js/factory.js. Transactions, categories, and sign-in are left alone. To change what “factory” means, edit that file.
Categories & payment methods
Rename or delete a category — its transactions, budgets, and planner settings move with it.
Rename a payment method — its transactions move with it, and future imports with the old name are mapped to the new one. Optional Default Spent by fills Add Transaction and Import (blank = who's entering).
Theme & page background
How much the page background shows through cards, transaction tiles, stats, and bill tiles. 0% is solid. Saved on this device.
Blurs the page background behind transparent cards, transaction tiles, stats, and bill tiles. Most visible when Card transparency is above 0%. Saved on this device.
Accent and surface colors for buttons, segments, and cards in dark theme. Saved on this device.
No saved backgrounds yet — use Open editor or MH editor, then Save.
Motion & effects Optional · any theme
Presets, color, picture, and the editor work in any theme. Motion effects pause with reduced-motion. Saved on this device.
Interface
Theme
Seven complete looks. Text, buttons, and borders meet WCAG AA contrast. A theme replaces the color palette. Page background stays as you set it.
Type
Each option pairs a title face with a body face. You choose the pair, not each role.
Dialogs
Order of the Save and Cancel buttons in dialog button bars. Saved on this device.
Position of the delete (trash) icon in dialog button bars. Saved on this device.
Drop shadow on cards, transaction tiles, stat panels, bill tiles, and sticky filter bars. Reset returns the built-in default; Off removes shadow everywhere. Saved on this device.
Space on the left and right of the content, so the page background shows through. Saved on this device.
Solid sets the card fill color. Patterns layer on the theme card (transparent fill) and the color control tints the pattern ink. Intensity and spacing apply to patterns only. Saved on this device.
Transaction edit sheet
Drag to reorder the fields on the transaction form. Saved on this device.
Transaction types, card titles, and visible fields
Drag to set the order types appear in each day on Transactions (top = first). Which types show is controlled by Filters → Type (All includes transfers; Income & Expense omits them). Saved on this device.
Drag to set the order fields appear under each transaction (top = first). Toggle 👁 to show/hide, Truncate/Wrap for line breaks, Inline/Full for width. Merchant name controls the title line. Saved on this device.
On days with more than one transaction, show the day's total expenses and income above the transactions. Transfers are excluded. Saved on this device.
Pill puts the totals on a backdrop. Subtle uses a faint rectangle. Plain blends them with the day label. Amount colors match transaction list amounts.
Style of the floating + button on the Transactions page. Saved on this device.
When the button is visible, show a short “Add” caption beside the + or keep the icon alone. Not used when Don’t show is selected.
Tab bar
Icons only, text labels only, or both on the bottom tab bar. Saved on this device.
Drag to rearrange (top = leftmost), or drag the icons in the bottom tab bar. Toggle 👁 to show or hide a tab. Saved on this device.
How the \u2190 Back button at the left of the tab bar looks: the accent pill, plain like the other tabs, or not shown. The keyboard shortcut below keeps working when it's hidden \u2014 and if every tab is hidden, the button stays as a safety net so you always have a way out. Saved on this device.
The \u2190 Back button at the left of the tab bar returns to the page you were on before the current one. Click the shortcut button, then press a new key or key combination to change it. Saved on this device.
Google Sheets setup
- Open your Money Buddy Google Sheet.
- Choose Extensions → Apps Script.
- Paste in the provided Code.gs file.
- Deploy → New deployment → Web app
Execute as: Me · Who has access: Anyone
Paste the Web app URL above.
Debug
Diagnostic tools for troubleshooting. Saved on this device.
Shows a background color on the description field in the transaction list (for diagnosing layout issues).
Shows a background color on the notes field in the transaction list.
☕ Enjoying Money Buddy?
Money Buddy is free, and the core always will be. If it's saved you time or money, you can buy me a coffee — it keeps the lights on.
☕ Buy me a coffee☕ Enjoying Money Buddy? Buy me a coffee
Loading...
Wish List
Things you want to buy, before you spend.
Bank connection (Plaid)
Read-only test — link a bank and fetch transactions. Nothing is saved to Firestore, Sheets, or this app’s storage. Requires the local bank-harness server (secrets never live in the browser).
Not checked yet.
Connect
Sandbox: any institution + user_good / pass_good, or use Quick link for a fake bank. Real bank: set PLAID_ENV=development in bank-harness/.env.
Log
—
Transactions
Setup
- In a terminal:
cd bank-harness && cp .env.example .env - Paste Sandbox keys from Plaid → Keys into
.env - Run
npm install && npm start(listens on port 4545) - Come back here → Check → Connect
Developer — first-run defaults
Dave-only workbench: configure what a brand-new data file starts with. Changes are a draft — preview them on this device, then export the JSON for Astro to bake into the app.
👁️ PREVIEWING draft defaults on this device.
Tabs visible by default
Which tabs a brand-new user sees. Hidden tabs stay available under Settings → Tab bar.
Default Home charts
Checked charts are in the default Home lineup (the wizard can still override per user).
Default Reports charts
Checked charts are in the default Reports lineup.
Coach marks
One-time hint bubbles per page: order them, edit the copy, toggle them. to preview again.
Usage metrics
Active foreground time per page, tracked on this device only. Powers the tip-jar unlock: the header ☕ pill appears after 30 min of use across 3+ days.