Awesome Open Source
Awesome Open Source

Blazing fast GitHub Pages deploy

The most blazingest action to deploy your GitHub pages website

Why did you make another action to deploy to GitHub pages?

This GitHub action uses JavaScript for maximum speed .

Using a JavaScript action simplifies the action code and executes faster than a Docker container action.


  1. Create a new workflow by adding .github/workflows/deploy.yml to your project.
  2. Create a personal access token
  3. Create a secret containing the personal access token, call it GH_PAT
  4. Modify the workflow options for your project

Here is an example deploy.yml file:

name: Blazing fast GitHub Pages deploy

    - main

    runs-on: ubuntu-latest
      - uses: actions/[email protected]
      - name: npm install, test and build
        run: |
          npm install
          npm run test
          npm run build
      - name: Deploy site to gh-pages branch
        uses: alex-page/[email protected]
          repo-token: ${{ secrets.GH_PAT }}

Workflow options

If you want a more custom experience you can add these values. For more detailed explanation of the workflow file, check out the GitHub documentation.

Setting Description Default value Required
repo-token The personal access token ${{ secrets.GH_PAT }} true
site-directory The site directory _site false
commit-message The commit message for the branch Deployed using Blazing fast GitHub Pages deploy action false
deploy-branch The branch to deploy the built website to gh-pages false


"could not read Username for '': No such device or address"

This is due to the deployed site folder containing a .git directory. It is recommended to build the site in a new folder for deployment.

Release History

  • v1.1.0 - Use environment variables, remove @actions/github dependency, remove TypeScript
  • v1.0.3 - Use environment variable for repository
  • v1.0.2 - Use head_commit for when there is no push
  • v1.0.1 - Return on error
  • v1.0.0 - Remove required name and email. Fix breaking bug with incorrect repository URL.
  • v0.0.1 - TypesScript, use callback instead of async
  • v0.0.0 - Initial release

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,512,666
Github Actions (4,175
Github Pages (2,644
Static Site (1,512
Deploy (617
Related Projects