Rebuild the public website for the plugin-first product

old/.github/workflows/site.yml → .github/workflows/site.yml

@@ -1,5 +1,5 @@
 #
-# Date: 2026-06-09
+# Date: 2026-06-15
 # Author: Spicer Matthews (spicer@cloudmanic.com)
 # Copyright: 2026 Cloudmanic Labs, LLC. All rights reserved.
 #
@@ -10,14 +10,13 @@
 # binary (no Node toolchain), then build Hugo with --minify. Output is the
 # www/public directory, uploaded as the Pages artifact.
 #
-# First-time setup (once, in the repo on GitHub):
-#   Settings → Pages → Build and deployment → Source: "GitHub Actions".
-# The site then publishes at https://cloudmanic.github.io/herdr-plus/.
+# This workflow is the *only* one that ships the website — the release pipeline
+# (release.yml) ignores www/** so a docs-only change never cuts a binary release.
 #
-# Custom domain later (herdrplus.com): in hugo.toml set
-#   baseURL = "https://herdrplus.com/"
-# add a file www/static/CNAME containing "herdrplus.com", point the domain's
-# DNS at GitHub Pages, and set the custom domain under Settings → Pages.
+# One-time setup (already done for this repo): Settings -> Pages -> Source:
+# "GitHub Actions". The site publishes to the custom domain herdrplus.com, set by
+# www/static/CNAME (Hugo copies it to the site root) plus the domain's DNS and the
+# custom-domain field under Settings -> Pages.
 #
 
 name: Site

.github/workflows/test.yml

@@ -5,9 +5,7 @@
 #
 # Test pipeline for herdr-plus. Runs the build, vet, and `go test ./...` with the
 # race detector on every push and pull request, on Linux + macOS, so we catch
-# platform-specific issues before they ship. Only the root module is exercised;
-# the archived reference code in old/ is a separate nested module and is ignored
-# by `./...`.
+# platform-specific issues before they ship.
 
 name: Test
 

Makefile

@@ -6,7 +6,7 @@
 
 BINARY := herdr-plus
 
-.PHONY: help build test test-short vet tidy plugin-link clean
+.PHONY: help build test test-short vet tidy plugin-link clean site site-dev site-clean site-deps
 
 # help is the default target so `make` with no args prints what's available.
 help:
@@ -20,6 +20,10 @@ help:
 	@echo "  make tidy         Run 'go mod tidy'."
 	@echo "  make plugin-link  Build, then link this checkout as a herdr plugin (dev)."
 	@echo "  make clean        Remove ./bin and coverage artifacts."
+	@echo ""
+	@echo "  make site         Build the www/ Hugo site into www/public (mirrors CI)."
+	@echo "  make site-dev     Run the site locally with live reload at http://localhost:1313/."
+	@echo "  make site-clean   Remove the site's build output."
 
 # build produces a single binary at ./bin/$(BINARY) — the same path the plugin
 # manifest's [[build]] step and entry points use.
@@ -52,3 +56,36 @@ plugin-link: build
 # clean removes build artifacts and coverage output.
 clean:
 	rm -rf bin coverage.out coverage.html
+
+# ---------------------------------------------------------------- website ---
+# The marketing + docs site lives in www/ as a Hugo site styled with Tailwind
+# v4 (standalone binary — no Node). These targets mirror the GitHub Actions
+# deploy in .github/workflows/site.yml.
+
+# site-deps fails early with a friendly message if hugo/tailwindcss are missing.
+site-deps:
+	@command -v hugo >/dev/null 2>&1 || { echo "✗ hugo not found — install with: brew install hugo"; exit 1; }
+	@command -v tailwindcss >/dev/null 2>&1 || { echo "✗ tailwindcss not found — install with: brew install tailwindcss"; exit 1; }
+
+# site builds the production static site into www/public.
+site: site-deps
+	@echo "→ Compiling Tailwind CSS…"
+	@cd www && tailwindcss -i assets/css/app.css -o static/css/app.css --minify
+	@echo "→ Building Hugo site…"
+	@cd www && hugo --minify --gc
+	@echo ""
+	@echo "✓ Built www/public — preview the whole thing with: make site-dev"
+
+# site-dev runs Tailwind in --watch alongside Hugo's live-reload dev server.
+site-dev: site-deps
+	@echo "→ Tailwind --watch + Hugo dev server on http://localhost:1313/ …"
+	@cd www && ( \
+		tailwindcss -i assets/css/app.css -o static/css/app.css --watch & \
+		TW=$$!; \
+		trap "kill $$TW 2>/dev/null" EXIT INT TERM; \
+		hugo server --disableFastRender \
+	)
+
+# site-clean removes generated site output.
+site-clean:
+	rm -rf www/public www/resources www/static/css/app.css

README.md

@@ -9,9 +9,6 @@ herdr-plus is an add-on for [herdr](https://herdr.dev), built as a first-class
 - **[Quick Actions](#quick-actions)** — a fuzzy launcher for one-off
   actions/scripts, run in the directory you launched from.
 
-> This is a clean, plugin-first rebuild. The previous standalone-binary
-> implementation lives under [`old/`](old/) as reference and is not built.
-
 ## Install
 
 herdr-plus is a herdr plugin (requires **herdr ≥ 0.7.0**). Installing it registers
@@ -203,5 +200,5 @@ make test      # go test -race ./...
 make vet       # go vet ./...
 ```
 
-The repo root is the active Go module; `old/` is a separate nested module and is
-ignored by `go ... ./...`.
+The marketing + docs site lives in `www/` (Hugo + Tailwind). Build it with
+`make site`, or run it locally with live reload via `make site-dev`.