Skip to content

refactor: Switch to actions-based GitHub Pages deployment#8

Merged
PhilipMathieu merged 1 commit intomainfrom
claude/fix-pr-preview-deploy-01BHa8uuPpeKWwLCjzYZWwUk
Nov 16, 2025
Merged

refactor: Switch to actions-based GitHub Pages deployment#8
PhilipMathieu merged 1 commit intomainfrom
claude/fix-pr-preview-deploy-01BHa8uuPpeKWwLCjzYZWwUk

Conversation

@PhilipMathieu
Copy link
Owner

Simplified deployment by switching from branch-based (gh-pages) to actions-based artifact deployment. This is the recommended modern approach and requires less maintenance.

Main deployment:

  • Uses official actions/deploy-pages@v4 with artifact upload
  • Deploys from main branch only
  • No gh-pages branch management needed

PR previews:

  • Builds docs and uploads as downloadable artifact
  • Posts comment with preview instructions
  • Simpler than managing preview branches

Repository settings needed:

  • Go to Settings → Pages
  • Set source to "GitHub Actions" (not "Deploy from a branch")

This is much simpler and more reliable than managing a gh-pages branch.

Simplified deployment by switching from branch-based (gh-pages) to
actions-based artifact deployment. This is the recommended modern
approach and requires less maintenance.

Main deployment:
- Uses official actions/deploy-pages@v4 with artifact upload
- Deploys from main branch only
- No gh-pages branch management needed

PR previews:
- Builds docs and uploads as downloadable artifact
- Posts comment with preview instructions
- Simpler than managing preview branches

Repository settings needed:
- Go to Settings → Pages
- Set source to "GitHub Actions" (not "Deploy from a branch")

This is much simpler and more reliable than managing a gh-pages branch.
@PhilipMathieu PhilipMathieu merged commit 78ca98f into main Nov 16, 2025
9 of 13 checks passed
@PhilipMathieu PhilipMathieu deleted the claude/fix-pr-preview-deploy-01BHa8uuPpeKWwLCjzYZWwUk branch November 16, 2025 22:07
@github-actions
Copy link

📦 PR Preview Built

The site has been built and is available as a downloadable artifact in this workflow run.

To preview locally:

  1. Download the artifact from the workflow run
  2. Extract and open index.html in your browser

Or wait for this PR to be merged to see it live on GitHub Pages.

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.

2 participants