mcnanovna-docs/CLAUDE.md

mcNanoVNA Docs

Documentation site for mcNanoVNA — MCP server for NanoVNA vector network analyzer control.

• Production: https://mcnanovna.warehack.ing
• Git: git@git.supported.systems:RF/mcnanovna-docs.git
• Server: ssh -A warehack-ing@warehack.ing, repo at ~/mcnanovna-docs

Stack

• Astro/Starlight (static output)
• Docker multi-stage build (Node builder -> Caddy prod)
• caddy-docker-proxy on external caddy network
• Separate docker-compose.dev.yml for development overlay

Environment

Copy .env.example to .env:

COMPOSE_PROJECT=mcnanovna-docs
DOMAIN=mcnanovna.warehack.ing
MODE=prod

Commands

make up        # Start production (static Caddy server)
make dev       # Start development (Vite hot-reload)
make down      # Stop all containers
make logs      # Follow container logs
make build     # Build production image
make rebuild   # Force rebuild (no cache)
make shell     # Open shell in running container
make clean     # Remove containers, images, volumes

Deploy to Production

ssh -A warehack-ing@warehack.ing "cd ~/mcnanovna-docs && git pull && make up"