DEVOPS

PR-comment visual review with one-click baseline approval

On each pull request preview, renders the changed pages, posts an annotated visual review comment on the PR.

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerGitHub PR opened or updated with previewGitHubGitHub
  • ActionRender changed routes in headless browserBrowserbase
  • ActionPost diff montage as PR review commentGitHubGitHub
  • LogicBranch: maintainer replied /approve-baseline?
  • OutputPromote screenshots to baseline in S3AWS S3

What it does

This workflow keeps the visual baseline honest by putting a human in the loop. When a PR gets a preview deploy, it renders the affected pages, builds a diff montage, and posts it as a structured GitHub PR comment. Intentional UI changes are approved with a single comment command, which promotes the new screenshots to the baseline so the next preview compares cleanly.

When to use it

Use it when your visual diffs are noisy because the design genuinely changes often. Instead of a hard auto-block, this gives reviewers an inline visual review next to the code, and a clean way to bless intended changes without editing baseline files by hand.

How it works

  1. 1A GitHub pull_request event with an attached preview deployment triggers the run.
  2. 2The workflow reads the PR's changed files to decide which routes to render.
  3. 3A headless browser captures those routes and diffs them against the baseline.
  4. 4A diff montage is posted as a PR comment summarizing changed pixels per page.
  5. 5A branch listens for an `/approve-baseline` reply from a maintainer.
  6. 6On approval, the new screenshots are written to object storage as the updated baseline.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect BrowserbaseHeadless browsers, sessions, replays.
  3. 3
    Connect AWS S3Buckets, objects, signed URLs.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.