cfsite

Checks

What runs on every pull request besides the preview, and what to do when one of them goes red.

Visual regression

The visual job opens every page on the preview and on production in Playwright, takes full-page screenshots at a fixed viewport and compares them with pixelmatch (tests/visual.spec.mjs). There are no stored baseline images: production is the baseline.

Variant, not used here: on a site where pull requests are mostly content edits, run the comparison only when the toolchain changes (templates, styles, dependencies), since content edits change pages on purpose.

Lighthouse

The lighthouse job runs Lighthouse on the preview's home page and writes the scores into that deploy's preview comment, with two links:

Details that make the numbers usable:

link-checker.yml runs lychee over the published folder on pull requests, every Monday and by hand. Links that cannot work by design (this site links to a missing page on purpose) and sites that block CI runners are excluded, each with a comment saying why. Links to private repositories always fail: they look like 404s from outside.

Claude code review

claude-code-review.yml reviews every pull request automatically, and claude.yml answers @claude mentions in issues and pull requests. Both need the secret CLAUDE_CODE_OAUTH_TOKEN, set up with /install-github-app in Claude Code.