docs: add live site URL, deployment steps, CI/CD summary

Author: RivasMario

README.md

@@ -94,12 +94,18 @@ VALIDATOR: all screws inside plate, none overlapping cutouts
 | `--no-auto-align` | off | Skip brute-force; use raw KiCad coords + manual nudge |
 | `--pcb-dx` / `--pcb-dy` | 0 | Manual nudge after auto-align |
 
+## Live Site
+
+**https://kb-plate-validator.fly.dev**
+
+Hosted on Fly.io (Chicago). Auto-deploys on every push to `main` via GitHub Actions.
+
 ## Web Application
 
 The KB Plate Validator can also be run as a web application with a modern, drag-and-drop interface. It supports instant **SVG Preview** and multi-format exports:
 * **DXF**: Standard CAD format for SendCutSend and laser cutting.
-* **Gerber (ZIP)**: Production-ready files for JLCPCB and PCB manufacturers.
-* **3D (STL)**: Extruded 1.5mm solids for 3D printing and CAD modeling.
+* **Gerber (ZIP)**: Production-ready files for JLCPCB and PCB manufacturers (requires optional deps).
+* **3D (STL)**: Extruded 1.5mm solids for 3D printing and CAD modeling (requires optional deps).
 
 ### Running via Docker (Recommended)
 
@@ -304,14 +310,41 @@ SCREW_COMBO
 - Expected: 101 (96 pure + 5 combos)
 - Overlap conflicts: 5 marginal (acceptable clearance)
 
+## Deployment Setup (for maintainers)
+
+The site runs on Fly.io. One-time setup if you fork and want your own deployment:
+
+```bash
+# Install flyctl
+curl -L https://fly.io/install.sh | sh
+
+# Authenticate
+flyctl auth login
+
+# Create app (only once)
+flyctl launch --name your-app-name --region ord --yes --no-deploy
+
+# Generate deploy token, add to GitHub secrets as FLY_API_TOKEN
+flyctl tokens create deploy -x 999999h
+
+# First deploy
+flyctl deploy --remote-only
+```
+
+After that, every push to `main` auto-deploys via `.github/workflows/fly-deploy.yml`.
+
+**GitHub Actions workflows:**
+- `docker-publish.yml` — builds and pushes `ghcr.io/rivasmario/kb_plate_validator:latest` on every push to main
+- `fly-deploy.yml` — deploys to `kb-plate-validator.fly.dev` on every push to main
+
 ## Contributing
 
-PRs welcome. The image auto-publishes to `ghcr.io` on every merge to `main` via GitHub Actions.
+PRs welcome. The site auto-deploys on every merge to `main`.
 
 1. Fork → branch → change
 2. `docker build -t kb-plate-validator .` to validate locally
 3. Open a PR — CI will build the image automatically
-4. Merge → image ships
+4. Merge → site updates within ~2 min
 
 See `.github/pull_request_template.md` for the PR checklist.
 

handover.md

@@ -38,8 +38,15 @@
 
 ### Pending Issues / Next Steps
 - ~~**Bump Dockerfile base image to `python:3.12-slim`**~~ — **DONE** (was already 3.12-slim; gerbonara + cadquery already in requirements.txt).
-- **GitHub Actions CI/CD** — **DONE** (April 18, 2026): `.github/workflows/docker-publish.yml` builds on every PR, publishes `ghcr.io/rivasmario/kb_plate_validator:latest` on every merge to main. PR template added. `.gitignore` updated to exclude `.venv*/`.
-- **Make ghcr.io package public** after first workflow run: GitHub → Packages → `kb_plate_validator` → Package settings → Change visibility → Public. (Repo is already public; packages still default to private.)
+- **GitHub Actions CI/CD + Fly.io deployment** — **DONE** (April 18, 2026):
+  - `.github/workflows/docker-publish.yml` — builds on every PR, publishes `ghcr.io/rivasmario/kb_plate_validator:latest` on push to main
+  - `.github/workflows/fly-deploy.yml` — auto-deploys to `https://kb-plate-validator.fly.dev` on push to main
+  - `.dockerignore` added (excludes .venv, __pycache__, test scripts)
+  - PR template at `.github/pull_request_template.md`
+  - `.gitignore` updated to exclude `.venv*/`
+  - ghcr.io package visibility set to public
+  - `cadquery` and `gerbonara` removed from `requirements.txt` (too heavy for container; exporters.py handles missing imports gracefully)
+  - Fly.io app: `kb-plate-validator` in `ord` (Chicago), 1GB shared-cpu-1x, auto-stop when idle
 - **STL viewer** installed locally as `f3d` (lightweight, dnf package).
 - **Verify SendCutSend acceptance** of the new closed-LWPOLYLINE DXF output (should resolve their "open entities" error).
 - **Generate-route still single-threaded** — large plates take ~7s for legacy_chain alignment. Not blocking but a future optimization opportunity.