Recipe for github pages deploy (project on gh-pages w/ untracked files)
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Github Pages Deploy Recipe (Project + Ignored)

This repository includes a sample configuration for deployment to github pages using the project style configuration with the strategy of ignoring build files in the working tree and pushing to the gh-pages branch.

It does not include a working application just a stub index.html file.


module.exports = {
  input: 'src',
  output: 'public',
  devtool: false,
  deploy: {
    stage: {
      pages: {
        type: 'project',
        branch: 'gh-pages',
        ignored: true


Add the deploy remote to your local version of this repository:

git remote add deploy

Build the output files with makestatic --no-pack.

Install dependencies to get the deployment provider:

npm i

Deploy the application:

makestatic --no-pack --env stage --provider pages

To verify a redeploy run:

npm version patch && makestatic --no-pack --env stage --provider pages

You should now be able to see the HTML page at

Go ahead and delete the remote branch (git push origin :gh-pages) to clean up.

Created by mkdoc on February 12, 2017