65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
---
|
|
phase: quick-260610-czd
|
|
plan: "01"
|
|
subsystem: docs
|
|
tags: [docs, local-dev, deployment]
|
|
dependency_graph:
|
|
requires: []
|
|
provides: [host-side-local-dev-instructions]
|
|
affects: [docs/deployment.md]
|
|
tech_stack:
|
|
added: []
|
|
patterns: []
|
|
key_files:
|
|
created: []
|
|
modified:
|
|
- docs/deployment.md
|
|
decisions:
|
|
- "D: Sourcing .env manually with DB_HOST override is intentional — baking --env-file into the dev script would load DB_HOST=mariadb and break host-side dev."
|
|
metrics:
|
|
duration: "~5 min"
|
|
completed: "2026-06-10"
|
|
---
|
|
|
|
# Phase quick-260610-czd Plan 01: Fix docs/deployment.md local-dev command — Summary
|
|
|
|
**One-liner:** Added host-side local-dev subsection to deployment.md explaining DB_HOST override and exact two-terminal run commands.
|
|
|
|
## Tasks Completed
|
|
|
|
| # | Task | Commit | Files |
|
|
|---|------|--------|-------|
|
|
| 1 | Add "Running locally (host-side, no Docker)" subsection | 39e2ee0 | docs/deployment.md |
|
|
|
|
## Verification Output
|
|
|
|
```
|
|
$ grep -q "Running locally (host-side, no Docker)" docs/deployment.md && grep -q "DB_HOST=localhost pnpm --filter @familysync/api dev" docs/deployment.md && grep -q "pnpm --filter @familysync/pwa dev" docs/deployment.md && grep -q "set -a; source .env; set +a" docs/deployment.md && echo "ALL CHECKS PASSED"
|
|
ALL CHECKS PASSED
|
|
```
|
|
|
|
```
|
|
$ git diff --name-only
|
|
docs/deployment.md
|
|
```
|
|
|
|
Only `docs/deployment.md` was changed. No code or package.json modifications.
|
|
|
|
## Deviations from Plan
|
|
|
|
None — plan executed exactly as written.
|
|
|
|
## Known Stubs
|
|
|
|
None.
|
|
|
|
## Threat Flags
|
|
|
|
None — docs-only change introduces no new security surface.
|
|
|
|
## Self-Check: PASSED
|
|
|
|
- `docs/deployment.md` exists and contains all required strings.
|
|
- Commit `39e2ee0` exists on `gsd/v1.0-milestone`.
|
|
- No other files modified.
|