auto: docs sync 2026-05-02T00:00:04+00:00

Files changed: docs/navi/cc-rules.md docs/navi/deployment.md docs/navi/themes.md

docs/navi/deployment.md

@@ -0,0 +1,55 @@
+# Navi Deployment
+
+## Source Repository
+
+**Location:** VM 1130 (`192.168.1.130`) at `/home/zvx/projects/repos/navi`
+
+> **WARNING:** Never deploy from `/home/zvx/projects/navi-work` on cortex — that clone is stale.
+
+## Build & Deploy
+
+```bash
+# SSH to VM 1130
+ssh recon-vm
+
+# Always backup first
+cp -r /mnt/nav/frontend /mnt/nav/frontend.bak.$(date +%Y%m%d-%H%M%S)
+
+# Build and deploy
+cd /home/zvx/projects/repos/navi
+npm run build && rsync -av --delete dist/ /mnt/nav/frontend/
+```
+
+## Infrastructure
+
+- **Nginx** on VM 1130 serves `/mnt/nav/frontend/` on port 8440
+  - `index.html`: no-cache (always fresh)
+  - Hashed assets (`*.js`, `*.css`): cache forever
+- **Caddy** on CT 101 routes `navi.echo6.co` → VM 1130:8440
+
+## Pre-Deploy Checklist
+
+1. Merge feature branch to master before deploying
+2. Check for unmerged upstream commits:
+   ```bash
+   git log your-branch..master --oneline
+   ```
+3. Create backup (see above)
+
+## Post-Deploy Smoke Tests
+
+Run after **every** deploy:
+
+- [ ] Route between two addresses — polyline renders
+- [ ] Click city label — boundary outline appears
+- [ ] Theme switching works (dark, light, clean, cyberpunk)
+- [ ] Toggle overlays (hillshade, contours, public lands)
+- [ ] Console: no `bt is not defined` or `f is not defined` errors
+
+## Rollback
+
+```bash
+# If deploy fails, restore backup
+rm -rf /mnt/nav/frontend
+mv /mnt/nav/frontend.bak.YYYYMMDD-HHMMSS /mnt/nav/frontend
+```