| name | local-ci |
| description | Run this repository's local CI parity commands and `pnpm run ci:local` jobs. Use when validating a change against the same job shapes used in GitHub Actions, choosing the smallest local CI job for a package, workflow, E2E, Metro, devtools, bundle-size, or build-and-test change. |
Local CI
Use the local CI runner and Turbo/package scripts as the source of truth for validation in this repo.
Quick Start
- Start with the smallest deterministic check that matches the change.
- Prefer
pnpm run ci:local --only=<job> for CI-parity validation.
- Prefer direct Turbo or package scripts only when they are the smaller equivalent of the CI job.
- Report exactly which command ran, what failed first, and which expected checks were skipped.
Workflow
1. Inspect available local CI jobs
Run:
pnpm run ci:local --list
Use this when the right job is unclear or when the repo may have added or renamed jobs.
For the current job map, read references/jobs.md.
2. Pick the smallest matching job
Use these defaults:
- Package code in
packages/*: start with build-and-test only if the change is broad; otherwise prefer package build/test commands.
- Metro packages or Metro workflow changes: use
build-metro, then Metro E2E jobs only if relevant.
- E2E app changes: run the matching
e2e-* job instead of build-and-test.
- Devtools workflow or Playwright/devtools changes: run
devtools.
- Bundle-size workflow/reporting changes: run
bundle-size.
- GitHub workflow syntax only: use
actionlint locally only to see skip behavior; the actual action is CI-only.
- Broad CI, packaging, publint, Turbo, or shared runtime changes: run
build-and-test.
3. Run commands in CI order
When reproducing CI, use the same command shape as the repo:
pnpm run ci:local --only=build-and-test
pnpm run ci:local --only=devtools
pnpm run ci:local --only=e2e-runtime
To run more than one job:
pnpm run ci:local --only=build-and-test,bundle-size
4. Interpret failures correctly
- Treat the first failing step as the actionable failure.
- Ignore known noisy warnings unless they exit non-zero.
- Distinguish repo-wide drift from changed-file gates.
- If
ci:local fails in Check code format, inspect the changed-file formatter result before running broader builds.
- If a dependency build outside the touched scope fails, note it separately as an unrelated blocker.
Common Cases
Broad package or runtime/plugin change
Run:
pnpm run ci:local --only=build-and-test
If that fails on format first, fix the changed files before rerunning the whole job.
One package only
Prefer the smaller direct command first:
pnpm exec turbo run build --filter=@module-federation/<pkg>
pnpm exec turbo run test --filter=@module-federation/<pkg> --force
Then run build-and-test only if the user asks for CI parity or the package change affects shared build/runtime behavior.
E2E change
Run the matching job from references/jobs.md, not the whole matrix.
Workflow change
Use the local CI job if one exists for the workflow's behavior. For workflow syntax, pair local validation with the repo's actionlint path when relevant.
Notes
ci:local sets CI=true and mirrors the repo workflow order.- Some jobs intentionally skip GitHub-only actions such as
actionlint and bundle-size-comment.
- The repo uses
pnpm, Node 24, and Turbo as the standard execution path.
- In worktrees, still use Turbo/package scripts directly as documented by the repo instructions.
