--- name: Four Environments description: Clear distinction between dev mode (local mock), dev server (228), demo (Portainer), and prod (same as dev server) type: project --- Four distinct environments — use correct terminology: | Name | What | Where | Backend | Deploy | |------|------|-------|---------|--------| | **Dev mode** | Local macOS, mock backend | `localhost:8100` | `mock-backend.js` on `:5959` | `npm run dev:mock` | | **Dev server / Prod** | Primary build/test/live server | `192.168.1.228` (+ fleet) | Real Rust backend + Podman | `deploy-to-target.sh --live` | | **Demo** | Public demo instance | Remote server | Mock Node.js via Docker | Portainer Stacks / `docker-compose.demo.yml` | - Dev server and prod are the SAME machine (192.168.1.228) — "prod" just means "the live deployment" - Demo is completely separate — user deploys via Portainer UI, Claude has no SSH access - Dev mode is local-only, no containers needed, fastest iteration **Why:** User corrected ambiguous usage of "dev servers (prod)" — these are the same thing, not two separate environments. **How to apply:** Always say "dev mode" for local mock, "dev server" or "prod" for 228, "demo" for the Portainer instance. Never conflate them.