From 2bf6515cbbcf9951c780bc2fa733e6ab6dfa6731 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Fri, 13 Feb 2026 01:51:00 -0700
Subject: [PATCH] Add deployment instructions and site links to CLAUDE.md

---
 CLAUDE.md | 93 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..4cfc0a4
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,93 @@
+# Genpix SKYWALKER-1 USB 2.0 DBB-s card
+SkyWalker-1 is a standalone advanced USB 2.0 DVB-s card.
+
+Supported modulations:
+
+DVB-S (QPSK)
+Turbo-coded QPSK
+Turbo-coded 8PSK
+Digicipher II Combo
+Digicipher II Split (I/Q)
+Digicipher II Offset QPSK
+DSS (QPSK)
+
+DVB-S2 standard is not supported (incompatible FEC)
+
+Symbol Rate: 256Ksps - 30Msps
+
+
+RF specification
+
+• Frequency range: 950-2150 MHz
+• input connector: IEC F-type female
+• LNB/switch control: 13/18V (or 14/19V), 22 kHz, Tone Burst, DiSEqC 1.0/1.2, Legacy switch commands,  max. 750 mA *
+
+* 750mA is maximum NON-continuous (for several minutes) allowable load. To avoid overheating, it's advisable not to exceed 450mA for permanent load.
+
+# Documentation Site
+
+Live at **https://skywalker-1.warehack.ing** — Astro Starlight, 37 pages, 9 sidebar groups.
+
+## Deployment
+
+Production runs on `warehack-ing@warehack.ing` via Docker + caddy-docker-proxy.
+
+**Repo:** `git@git.supported.systems:warehack.ing/skywalker-1.git` (Gitea, private)
+
+**Server layout:**
+```
+~/skywalker-1/          # git clone
+  site/
+    .env                # not committed — see below
+    docker-compose.yml  # caddy-docker-proxy labels
+    Dockerfile          # multi-stage: dev (Astro HMR) / prod (Caddy static)
+    Makefile            # shortcuts: make up, make prod, make logs
+```
+
+**`.env` on production server** (`~/skywalker-1/site/.env`):
+```env
+COMPOSE_PROJECT=skywalker-1-docs
+APP_ENV=prod
+APP_PORT=80
+PUBLIC_DOMAIN=skywalker-1.warehack.ing
+VITE_HMR_HOST=
+```
+
+**Deploy / update:**
+```bash
+ssh -A warehack-ing@warehack.ing
+cd ~/skywalker-1 && git pull
+cd site && make prod      # rebuilds container with APP_ENV=prod, serves static via Caddy
+make logs                 # verify startup
+```
+
+**First-time setup** (already done):
+```bash
+ssh -A warehack-ing@warehack.ing
+ssh-keyscan -t ed25519 git.supported.systems >> ~/.ssh/known_hosts
+git clone git@git.supported.systems:warehack.ing/skywalker-1.git ~/skywalker-1
+# create site/.env as above
+cd ~/skywalker-1/site && make prod
+```
+
+TLS is automatic via caddy-docker-proxy (ACME DNS challenge, Vultr API). New certs take ~2 min.
+
+## Local Dev
+
+```bash
+cd site
+npm install
+npm run dev          # http://localhost:4321
+```
+
+Or with Docker (HMR via volume mounts):
+```bash
+cd site
+# set APP_ENV=dev, APP_PORT=4321 in .env
+make dev
+```
+
+# Links
+- [Live Docs](https://skywalker-1.warehack.ing)
+- [Gitea Repo](https://git.supported.systems/warehack.ing/skywalker-1)
+- [Genpix Official Site](https://www.genpix-electronics.com/index.php?act=viewDoc&docId=9)