Skip to content
Back to projects
In progress

cherry-money — an expense tracker that explains its advice

Expense tracker for Spain: imports Norma 43, Revolut and N26 statements, forecasts cash flow 90 days out and advises with rules that show their numbers.

What it is

An income and expense tracker built for Spain. Movements are typed by hand or imported from the bank; from there it shows where the money goes month by month, keeps category budgets and savings goals, plans the bills that do not come every month (property tax, insurance, extra salary payments) and forecasts the cash flow of the next 30, 60 and 90 days. It never moves money.

What sets it apart

  • Advice you can check. It comes from deterministic rules, not a model: savings rate, 50/30/20, category spikes, the month’s spending pace, recurring charges, budgets about to run out, a yearly reserve for irregular expenses, goals that are falling behind. Each piece of advice arrives with the numbers its rule used and, where it can be estimated, the monthly saving.
  • Idempotent import of Norma 43 (AEB43), Revolut and N26 statements. What is already stored is skipped, so a file that overlaps another can be imported again without duplicating anything.
  • It finds the bills that repeat. It looks at two years of movements and suggests the ones that come back every 1, 2, 3, 6 or 12 months at a similar amount; they only count in the forecast once the user accepts them.
  • A cash-flow forecast with its tightest point: how much the account needs today to reach payday without going overdrawn. Every line can be traced to a recurring flow you can see and edit.
  • Receipts and voice notes. A photo of a receipt or a note in Spanish becomes a movement to review; nothing is stored until you confirm it. The text comes from EasyOCR and faster-whisper, optional extras of the API, and is read by rules, not a model. This part lives in the API only, not in the mobile app.

The same rules on the server and in your pocket

  • API in FastAPI with clean architecture, on PostgreSQL or SQLite.
  • Web in Astro with React islands, in two editions chosen at build time: the calculators (an investment simulator and a rental-property return calculator) and the full tracker.
  • App in Expo: the same rules running on the device over SQLite, with no server, and a backup the user stores wherever they like.
  • Shared golden cases between the API and the app, with exact decimals end to end, so both give the same result to the cent.
  • An OpenAPI contract as the single source of truth between the API and the web.

Quality

The API gate requires 100% line and branch coverage, and the web gate 100% of lines. They run twice: in the pre-push hook and on GitHub Actions, with the e2e in Chromium, Firefox and WebKit.

Stack: Python 3.12 · FastAPI · SQLAlchemy · PostgreSQL/SQLite · Astro 7 · React 19 · Expo 54 · React Native · TypeScript.

Private repository · in daily use by its author, in development.