Skip to content

Add GitHub Pages (GitHub Actions) publishing mode#18

Open
geoffreymcgill wants to merge 1 commit intomainfrom
feat/pages-publish-mode
Open

Add GitHub Pages (GitHub Actions) publishing mode#18
geoffreymcgill wants to merge 1 commit intomainfrom
feat/pages-publish-mode

Conversation

@geoffreymcgill
Copy link
Contributor

@geoffreymcgill geoffreymcgill commented Feb 13, 2026

Implements issue #17 by adding a new publishing mode for repositories configured with GitHub Pages Source: GitHub Actions.

Key changes

  • New input publish-to (default branch; new value pages)
  • Pages mode uploads a Pages artifact and optionally deploys it using:
    • actions/configure-pages@v5
    • actions/upload-pages-artifact@v3
    • actions/deploy-pages@v4
  • New inputs: pages-path, pages-artifact-name, pages-retention-days, pages-deploy
  • New outputs: page_url, artifact_id
  • Existing branch/directory/PR behavior remains unchanged when publish-to != pages

Usage (Pages mode)

Workflow must grant:

  • pages: write
  • id-token: write
  • contents: read

See README for the full example.

Supports publish-to: pages using configure-pages, upload-pages-artifact, and deploy-pages while preserving existing branch/PR publishing.
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

Comments