feat: same as initial commit

README.md

@@ -0,0 +1,42 @@
+# Family Budget
+
+Local SPA for family budget tracking: import bank statements, categorize transactions, view analytics.
+
+## Monorepo structure
+
+```
+family_budget/
+├── backend/     — Node.js API server (Express + TypeScript)
+├── frontend/    — React SPA (Vite + TypeScript)
+├── shared/      — Shared TypeScript types (API contracts, entities)
+├── docs/        — Specifications and backlog
+└── package.json — npm workspaces root
+```
+
+## Tech stack
+
+| Layer    | Choice                 | Rationale                                              |
+|----------|------------------------|--------------------------------------------------------|
+| Backend  | Express + TypeScript   | Simple, well-known, sufficient for a small local app   |
+| Frontend | React + Vite + TS      | Fast dev experience, modern tooling                    |
+| Database | PostgreSQL             | Deployed on Synology NAS                               |
+| Migrations | Knex                 | Lightweight, SQL-close, supports seeds                 |
+| Shared   | Pure TypeScript types  | Zero-runtime, imported by both backend and frontend    |
+
+## Prerequisites
+
+- Node.js >= 20
+- PostgreSQL >= 15
+- npm >= 10
+
+## Getting started
+
+```bash
+# Install all workspace dependencies
+npm install
+
+# Build shared types (must be done before backend/frontend)
+npm run build -w shared
+```
+
+See `backend/README.md` and `frontend/README.md` for per-package instructions.