---
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.
