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