Skip to content

Document production build and deployment flow - #57

Merged
digiguru merged 3 commits into
masterfrom
docs/production-build-readme
Aug 14, 2026
Merged

Document production build and deployment flow#57
digiguru merged 3 commits into
masterfrom
docs/production-build-readme

Conversation

@digiguru

@digiguru digiguru commented Aug 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • rewrite the README around the current Pure architecture and two-repository production deployment
  • document the exact-SHA dispatch from digiguru/presentation to digiguru/digiguru.github.io
  • document the GitHub Pages export/deploy path and distinguish it from Vercel previews
  • add the production URL prominently: https://art.digiguru.co.uk/presentation/
  • add the production URL to package.json homepage metadata
  • document key operational watch-outs, including WEBSITE_DISPATCH_TOKEN, Pages ownership, canonical-source rules and the current dispatch-website -> needs: build dependency
  • add a narrowly scoped cleanup workflow that runs when it lands on master and removes the obsolete migration/experiment branches plus this PR branch

Important finding

The current dispatch-website job depends on build only, not the separate pure job. The README now states that accurately rather than implying every CI job blocks production dispatch.

Branch cleanup

There are no open PRs in this repository. The remaining non-master branches are merged migration branches, explicitly closed/superseded experiments, or the redundant pre-final Stage 7 branch (agent/stage-7-canonical-sources is 0 commits ahead of master).

Because master is protected and the GitHub connector does not expose direct ref deletion, .github/workflows/cleanup-stale-branches.yml uses the repository GITHUB_TOKEN with contents: write to delete those known refs after this PR lands. Its push trigger is path-scoped to that maintenance workflow, so normal future pushes do not rerun the cleanup.

Validation

Normal repository CI validates the README/package metadata and actionlint validates the cleanup workflow before merge.

@vercel

vercel Bot commented Aug 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
presentation Ready Ready Preview Aug 14, 2026 12:59pm

Request Review

@digiguru
digiguru merged commit e1fd324 into master Aug 14, 2026
6 checks passed
@github-actions
github-actions Bot deleted the docs/production-build-readme branch August 14, 2026 13:01
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