Personal Finance Tracker
Half-built but running web app draft for tracking personal income, expenses, and simple cashflow habits.
Description
A client-side personal finance tracker: dashboard overview, budgets with spend-vs-limit alerts, charted reports, recurring transactions, multi-currency display (USD/IDR/SGD/EUR/GBP), and CSV export. All data is stored in the browser via localStorage — there's no database or login, which makes it the simplest product in the catalog to run and demo, but data doesn't sync across devices.
What Already Works
- Dashboard overview with account balances, recent activity, and quick-add
- Activity log with search, filter, edit, delete, and swipe-to-delete on mobile
- Budgets with spend-vs-limit tracking and 80%/100% alerts
- Charted reports (Recharts)
- Recurring transactions (weekly/monthly) that auto-generate future occurrences
- Multi-currency display: USD, IDR, SGD, EUR, GBP
- CSV export
- Dark/light theme
What's Included
- Full source code
- README and setup guide
- License
- AI-ready docs (PRD, technical spec, deployment notes)
- Custom Express production server (server.ts)
How to Run
- Unzip the source and run npm install.
- Copy .env.example to .env if you want to set a custom APP_URL (optional).
- Run npm run dev and open http://localhost:3000 — no database setup needed.
- Build for production with npm run build, then start with npm run start (needs a Node host, not Vercel serverless).
Continuation Notes
- Cannot run on Vercel serverless — needs a Node host like Render, Railway, or a VPS.
Known Limitations
- No accounts or login — single-user only, by design
- No database or cross-device sync — all data lives in the browser's localStorage and clears if browser data is cleared
- Currency exchange rates are hardcoded, not live
- Cannot deploy to Vercel serverless — ships a custom Express server, needs a Node host (Render, Railway, Fly.io, or a VPS)
- Still needs human or developer review before shipping
Related Drafts
BatuWorkout Class Booking
Workout class booking draft with public schedule pages, booking/member/admin screens, and manual-payment MVP direction.
AlHijrah Islamic Digital Ecosystem
Full-stack Islamic super-app draft: Qur'an, prayer times, Qibla, mosque finder, Zakat/inheritance calculators, donations, and a marketplace across five main menus.