Skip to main content
JUMP TO:Quick StartCLI CommandsConfigurationPlaywright APIMCP ServerGitHub Actions
CI/CD / GitHub Actions(11 of 37)

GitHub Actions

PRE-RELEASE ACTION. The external consumer smoke is pending, so there is no public copy-ready Action workflow yet. Use the generated CLI workflow until publication, tag advancement, and both smoke controls pass.

For production repositories today, use the direct CLI workflow generated by frontguard init --ci (documented in the GitHub Actions guide). This page documents the repository-root composite action.yml contract and its permissions.

GitHub Actions Two-Lane Baseline Governance
FIG 01 · GITHUB ACTIONS WORKFLOW — FETCH ORIGIN/FRONTGUARD-BASELINES, COMPARE IN PR, PROMOTE EXPLICITLY

Release status

The repo-root action.yml is the future marketplace consumer shim. It requires contents: write only when update-baselines is true; PR reporting requires pull-requests: write. Default actions/checkout fetch-depth: 1 does not retrieve the frontguard-baselines orphan branch; the Action fetches that ref before comparing.

Permissions

Permission ScopeWhen RequiredReason
contents: readEvery Pull Request comparison runReads repository code and fetches origin/frontguard-baselines for comparison.
contents: writeExplicit baseline update runs onlyRequired when pushing newly accepted screenshots to the frontguard-baselines orphan branch.
pull-requests: writeOptional PR summary commentsAllows posting or updating the markdown diff summary table on the Pull Request.

Baseline updates

Updated baselines still require the workflow to push frontguard-baselines in explicit update mode. Do not infer that the public v0 ref has passed this journey until the external smoke test is recorded. merge_group never writes baselines, even when allow-baseline-writes is true, and the Action renders every route for that event.

Use on: [pull_request, merge_group] with an identical job name. A workflow-level paths: filter on a required check leaves the queue pending. Queue runs compare against the shared latest baseline until #306. Capture the PR head SHA and check out with fetch-depth: 0, which is the history smartFilter needs for git diff base...HEAD.

For a copy-ready GitHub Actions workflow using the published CLI today, see Guides: GitHub Actions.