Motoko GitHub CI Workflow

What This Is

This skill provides a comprehensive playbook for adding or updating a GitHub Actions CI workflow for Motoko projects. It covers automated testing, benchmarking, code formatting, and building (canisters or examples) using mops, moc, prettier, icp-cli, and dfx. It is a perfect companion to the mops-package-maintenance skill.

For general information on GitHub Actions, refer to the GitHub Actions Documentation. For Motoko-specific examples, you can explore public repositories in the research-ag organization.

Prerequisites

• mops CLI (local: npm i -g ic-mops, CI: caffeinelabs/setup-mops@v1)
• node (latest LTS recommended, at least v22 for Prettier)
• dfx (installed in CI via dfinity/setup-dfx@main) for running mops bench. dfx is the preferred runtime for benchmarks — it produces more accurate and stable numbers than pocket-ic and has proven significantly more reliable across our repositories. pocket-ic is only used in CI when it is already present in mops.toml [toolchain] (see Step 1).

How It Works