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.
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 Scope | When Required | Reason |
|---|---|---|
contents: read | Every Pull Request comparison run | Reads repository code and fetches origin/frontguard-baselines for comparison. |
contents: write | Explicit baseline update runs only | Required when pushing newly accepted screenshots to the frontguard-baselines orphan branch. |
pull-requests: write | Optional PR summary comments | Allows 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.
