Personal budgeting and spending intelligence. Production-grade. Multi-user infra, single-user UX.
cp .env.example .env
docker compose -f docker/docker-compose.yml up --build
Local dev (without Compose)
pnpm install
# Mongo + Redis still need to run somewhere — easiest is Compose for those two:
docker compose -f docker/docker-compose.yml up mongo mongo-init redis -d
pnpm dev
| Command |
What it does |
| pnpm dev |
Run web + api in parallel via Turbo |
| pnpm lint |
ESLint + Ruff across the monorepo |
| pnpm typecheck |
tsc + mypy (strict) |
| pnpm test |
Vitest + pytest |
| pnpm build |
Build all packages and apps |
| pnpm types:generate |
Regenerate TS types from the API OpenAPI snapshot |
| pnpm seed |
Populate the DB with 24 months of demo data |
apps/web — Next.js 15 frontend (App Router, styled-components v6)
apps/api — FastAPI backend (MongoDB + Beanie, Redis)
packages/ui — Design system (theme + components + Storybook)
packages/shared-types — TS types generated from the API OpenAPI schema
packages/tsconfig, packages/eslint-config — shared tooling presets
docker/ — Compose + Dockerfiles
docs/ — Plans, ADRs, test plans
See CLAUDE.md for conventions and the full architecture overview.