feb756cfe2
pdf-parse@2.4.5 pulls in @napi-rs/canvas (native Skia binary) which crashes on import in Alpine containers. Moved to lazy require() so the app starts normally and pdf-parse loads only when PDF conversion is actually requested. - Lazy-load pdf-parse in pdfToStatement to avoid startup crash - Add libc6-compat, fontconfig, freetype to Alpine runner stage - Increase npm fetch timeouts in both Dockerfiles for slow networks - Add connectionTimeoutMillis to pg Pool for faster failure detection
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
# 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.