Expense Tracker — Wallet Agent
An expense tracker for Bangladesh, in Taka. Track spending and income, set monthly budgets and savings goals, get bill reminders, and ask an optional AI assistant about your money in English or বাংলা.
Overview
What it does
Tracks expenses and income, monthly budgets per category, savings goals and recurring bills — everything in Taka, with “today” defined as the Asia/Dhaka date.
The AI assistant
Optional and off by default. It reads your data through read-only tools that always act as the signed-in user, with daily limits of 50 messages per user and a global dollar budget.
Architecture
The browser only talks to the Next.js site on Vercel, which proxies /api/* to the FastAPI service on Render, so the HttpOnly login cookie stays on the site's own domain. Data lives in Neon Postgres.
Key Features
Expenses
Quick add from your most-used categories, search, filters by category and date, and CSV export.
Budgets & goals
A limit per category with bars that turn amber at 80% and red when over; savings goals show how much to save each month.
Bills & income
Reminders for the next 7 days, marked paid or received with one tap; monthly income and savings rate.
Bilingual AI assistant
Ask in English, বাংলা or Banglish; answers use your own numbers. Type “rickshaw 80” to log an expense — nothing is saved until you confirm.
Works on phones
Bottom tab bar, layouts tested at 375px, dark mode, and installable as a PWA.
Accessible
Every page is checked against WCAG 2.1 AA with axe-core in light and dark mode.
Tech Stack
| Website | Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS, shadcn/ui, TanStack Query, Recharts |
|---|---|
| API | FastAPI, SQLAlchemy 2.1, Alembic, Pydantic 2, Python 3.11+ (uv) |
| Database | PostgreSQL 16 |
| AI | OpenRouter (Claude Haiku, Gemini Flash Lite as fallback), tool calling, server-sent events |
| Quality | pytest (~96% backend test coverage), Vitest, Playwright (e2e, layout, accessibility), ruff, mypy, ESLint, GitHub Actions |
| Ops | Docker, Vercel (website), Render (API), Neon (database), optional Sentry |