From c689644997969f90aa02eb8680ca53e5bd7d7fe7 Mon Sep 17 00:00:00 2001 From: Josh Rogers Date: Fri, 8 May 2026 23:11:17 -0500 Subject: [PATCH] Document scripts/dev-db.ps1 + dev-up.ps1 in CLAUDE.md So future agents (and humans) discover the helpers instead of stitching together the raw docker / dotnet / npm commands. Also notes that LoggingEmailSender prints invite and reset links to the API log when SMTP is unconfigured locally. --- CLAUDE.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index ebf653d..068ddbb 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,6 +15,17 @@ The repo is a small monorepo with two deployables plus an e2e harness at the roo ## Common commands +Local dev stack (preferred for everyday work): + +```powershell +./scripts/dev-up.ps1 # starts Postgres + API + frontend (each in its own window) +./scripts/dev-db.ps1 start # just the Postgres container (named yeschef-pg, on :5432) +./scripts/dev-db.ps1 reset # nuke the dev DB volume — next start is a fresh DB +./scripts/dev-db.ps1 status # connection string + container state +``` + +`dev-db.ps1` provisions a `postgres:17` container that matches the connection string baked into `appsettings.json` (`Host=localhost;Database=yeschef;Username=yeschef;Password=yeschef`). The API auto-applies migrations on startup. With no SMTP configured locally, outgoing emails (invites, password reset) print to the API log window via `LoggingEmailSender` — that's where to copy the join/reset URL from when manually testing those flows. + Frontend (run from `src/frontend`, use `npm --prefix src/frontend ` to avoid `cd`): ```powershell