GitHub Action to build and deploy a Github Pages site using the build command & output folder you specify.
This GitHub Action will run the build command you specify at the root of your repository and deploy it to GitHub Pages for you! Here's a basic workflow example:
# .github/workflows/main.yml
name: Github Pages Publish
on:
push:
branches:
- master
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v1
- uses: sterlingwes/[email protected]
with:
access-token: ${{ secrets.ACCESS_TOKEN }}
source-directory: public
build-command: yarn build| Name | Description | Required? (default) |
|---|---|---|
access-token |
Required to push chages to your deployment branch. You can get this from your Github Settings > Developer Settings > Personal Access Tokens | Yes |
source-directory |
The name of the subfolder that holds the contents of the site you want deployed. This folder can be generated by your build command, or pre-exist. | Yes |
build-command |
The command you want this Action to run to generate your static site files in the source-directory you specify. |
Yes |
deploy-branch |
The branch Github Pages is setup to source your site's files from. For the yourname.github.io site, this is typically the master branch. For /reponame subfolder deploys, gh-pages is the default. |
No (gh-pages) |
custom-domain |
This is the domain that this Action will write to a CNAME file for you on your deploy branch, to enable a custom domain for your Github Pages site. |
No |
This is based on a Gatsby-specific action written by Enrique Gonzalez 🙏