GitHub Actions

Note

This chapter is documentation for myself.

You do not need to modify workflows when contributing (including bumping versions). Please understand that all PRs that touch .github will be closed for supply-chain security.

Since the development activity is on GitHub, I use GitHub Actions to run CI. I use runners from Blacksmith to speed up some hot workflows.

The Standard provides composite actions for common workflows as well as copy-paste configs for composing workflows

File Structure

The workflow files should be placed in the following directory structure:

- .github/
  - steps/
    - setup/
      - action.yml
    - ... (more repo-specific reusable steps)
  - workflows/
    - pr.yml
    - ... (more .yml for workflows)

Blacksmith Runners

Blacksmith now has all of Ubuntu, MacOS (very expensive) and Windows runners:

blacksmith-4vcpu-ubuntu-2404
blacksmith-4vcpu-ubuntu-2404-arm
blacksmith-4vcpu-windows-2025
blacksmith-6vcpu-macos-latest

See https://docs.blacksmith.sh/blacksmith-runners/overview