blazing fast gh pages deploy

This Action is archived. I recommend using Custom GitHub Actions workflows to deploy to GitHub pages. Here is a code example of a migration off this GitHub action.

---

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.

Usage

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

on:
  push:
    branches:
    - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@main
      - 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]
        with:
          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

Troubleshooting

"could not read Username for 'https://github.com': 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