Skip to content

docs: deployment runbook (stop guessing the deploy path)#554

Open
w1ne wants to merge 1 commit into
developfrom
docs/deploy-runbook
Open

docs: deployment runbook (stop guessing the deploy path)#554
w1ne wants to merge 1 commit into
developfrom
docs/deploy-runbook

Conversation

@w1ne

@w1ne w1ne commented Jun 28, 2026

Copy link
Copy Markdown
Owner

Adds docs/DEPLOY.md mapping the three deploy surfaces and how each ships, plus a CLAUDE.md pointer.

Context: a fix can be merged to develop and be "live" on app.kernelcad.com while the marketing site (kernelcad.com) still serves old content — because the two deploy by different mechanisms and the marketing site is manual only.

  • app.kernelcad.com (Studio, src/) — auto-deploys on push to develop (deploy-cloudflare.yml).
  • kernelcad.com (marketing + gallery, site/) — deployed ONLY by a manual workflow_dispatch in the private kernelCAD-server repo (deploy-kernelcad-com.yml, web_ref default develop); content changes never auto-deploy.
  • npm — a v* tag is a full release (publishes packages + Demo discipline), not a per-surface deploy.

🤖 Generated with Claude Code

Maps the three deploy surfaces and how each ships:
- app.kernelcad.com (Studio) — auto on push to develop (deploy-cloudflare.yml)
- kernelcad.com (marketing + gallery) — MANUAL workflow_dispatch in the
  private kernelCAD-server repo (deploy-kernelcad-com.yml, web_ref=develop);
  content changes never auto-deploy
- npm — a v* release tag (full release, not a per-surface deploy)

Adds a CLAUDE.md pointer so future work reads the runbook first.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant