echo6-docs/docs/navi/deployment.md

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

# 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:

   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

# If deploy fails, restore backup
rm -rf /mnt/nav/frontend
mv /mnt/nav/frontend.bak.YYYYMMDD-HHMMSS /mnt/nav/frontend