GitHub Pages

If your site lives in a GitHub repository, GitHub Pages can host it for free. Publishing runs through GitHub Actions: you push your writing, and a workflow builds and deploys the site for you.

Configuration

Choose GitHub Pages during sumi init, or add this to sumi.json later:

{
  "deploy": {
    "provider": "github-pages"
  }
}

GitHub Pages uses GitHub Actions, so Sumi also generates .github/workflows/publish.yml when this target is selected during init. The workflow itself is described in GitHub Actions.

Repository settings

In GitHub, open the repository settings and configure Pages to deploy from GitHub Actions. This is a one-time setting; without it, the workflow builds the site but GitHub does not serve it.

Publishing

Push to GitHub, or run the generated workflow manually from the Actions tab. The workflow runs ./sumi publish and deploys the built site to GitHub Pages.

Secrets

GitHub Pages itself does not need deployment secrets. If you use syndication, add the provider variables from .env.example as GitHub Actions secrets.

If you want to check content, config and any syndication variables before pushing, run ./sumi doctor locally.