# JamesIves/github-pages-deploy-action

🚀 Automatically deploy your project to GitHub Pages using GitHub Actions. This action can be configured to push your production-ready code into any branch you'd like.

Repository: https://github.com/JamesIves/github-pages-deploy-action
Canonical: https://ross.abutalabs.com/products/github-pages-deploy-action
Homepage: https://github.com/marketplace/actions/deploy-to-github-pages
Language: TypeScript
License: MIT
License Family: permissive
Topics: github-actions, github-action, gh-pages, github-pages, deployment, deployer, cicd, ghpages, deploy, workflow, workflow-configuration, workflow-runs, github-enterprise, continuous-deployment, actions, action, continuous-delivery, continuous-integration, static, hacktoberfest
Last push: 2026-08-24T16:10:04+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 2741, "days_push": 9, "days_rel": 25, "gap_med": 18, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4603, forks 436 (observed 2026-08-28T04:08:54.868664+00:00)

## What it is
A GitHub Action that automatically deploys a project's production-ready build output to GitHub Pages, pushing to any branch such as gh-pages or docs. It supports cross-repository deployments and GitHub Enterprise.

## Use cases
- deploy a static site to github pages on push
- publish docs folder to gh-pages branch automatically
- set up continuous deployment for my website with github actions
- deploy built site to another repository's github pages
- automate github pages deployment in ci workflow

## When to choose
- you host static sites or documentation on GitHub Pages and want automated deployment from CI
- you need to deploy to a different branch or a different repository
- you use GitHub Enterprise and need Pages deployment support

## When to avoid
- you deploy to non-GitHub hosting like Netlify, Vercel, or S3
- you need server-side rendering or dynamic hosting rather than static Pages
- you prefer GitHub's native Pages deployment workflow without a third-party action

## Facets
- artifact type: plugin
- maturity: stable
- function: deployment, ci-cd
- domain: web-development
- platform: cloud
- tags: github-actions, github-pages, static-site-deployment, gh-pages, continuous-deployment, devops, automation, web-server

## Member repositories
- JamesIves/github-pages-deploy-action (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:54.868664+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:19:45.829305+00:00, confidence not recorded.
  - readme: https://github.com/JamesIves/github-pages-deploy-action (fetched 2026-08-28T04:08:54.868664+00:00, sha e339417b9966)
  - homepage: https://github.com/marketplace/actions/deploy-to-github-pages (fetched 2026-08-29T09:04:56.441596+00:00, sha 7b6e191948ae)
  - registry_npm: https://registry.npmjs.org/github-pages-deploy-action (fetched 2026-08-29T09:04:56.451308+00:00, sha b51e60b3a845)
- Data as of 2026-08-30T08:39:29.467469+00:00.