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.
This commit is contained in:
Josh Rogers
2026-05-08 23:11:17 -05:00
parent aa530cba97
commit c689644997
+11
View File
@@ -15,6 +15,17 @@ The repo is a small monorepo with two deployables plus an e2e harness at the roo
## Common commands ## 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 <cmd>` to avoid `cd`): Frontend (run from `src/frontend`, use `npm --prefix src/frontend <cmd>` to avoid `cd`):
```powershell ```powershell