☕ Coffee
Coffee is a personal finance manager built as an installable PWA. Track your
spending, income, accounts and savings goals from your phone, tablet or desktop —
with a fast, mobile-first interface and a numeric keypad designed for logging
transactions in seconds.
The UI is in Spanish and amounts are handled in Colombian pesos (COP).
Features
- Quick transaction entry — Add expenses and income through a full-screen
numeric keypad. Pick a category and account, add an optional note, and confirm.
- Accounts — Manage multiple account types: debit, credit cards, fixed income
and investments. Credit cards support credit limit, statement and due dates,
APR and card network.
- Categories — Organize expenses and income into customizable categories with
icons and colors.
- Savings goals — Set targets with optional deadlines and track your progress.
- Dashboard — See net worth, key metrics and recent activity at a glance.
- Analysis — Visualize your finances with net worth composition, savings
runway, spending heatmap, recurring subscriptions, category comparisons and
expense breakdowns.
- History — Browse, filter and edit past transactions.
- Apple Pay auto-capture — An iOS Shortcuts "Transaction" automation posts
every Apple Pay payment to
POST /api/integrations/apple-pay (personal Bearer
token, created in Cuentas → Apple Pay). The amount is parsed, the merchant
mapped to a category and the Wallet card to an account; the PWA pulls new
movements when it returns to the foreground.
- PWA — Installable on mobile and desktop, with offline-friendly UX and a
home-screen shortcut for quick transaction entry.
- Secure auth — Email/password accounts with JWT stored in an httpOnly cookie.
Tech stack
- Next.js (App Router) + TypeScript
- Tailwind CSS + shadcn/ui
- MongoDB
- Zustand (state), Recharts (charts), Zod (validation),
jose (JWT)
Getting started
npm install
npm run dev
Create a .env.local file with your MongoDB connection string and JWT secret:
MONGODB_URI=...
JWT_SECRET=...
Then open http://localhost:3000.
Scripts
npm run dev # start the dev server
npm run build # production build
npm run start # run the production build
npm run lint # lint
npm run typecheck # type-check
