CONTENT CREATION

Flag UI-changed docs screenshots after a release and queue recaptures

After a frontend release ships, this compares the current UI against the screenshots embedded in your docs and queues recapture tasks for every screen whose UI visibly changed.

CategoryContent Creation
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerGitHub release publishedGitHubGitHub
  • ActionFetch documented-screen manifest from ReadMeReadMeReadMe
  • ActionCapture each screen on the new build via BrowserbaseBrowserbase
  • LogicDiff against stored shots, keep changes over threshold
  • OutputOpen Linear recapture task per drifted screenLinearLinear

What it does

When a frontend release is tagged on GitHub, this template re-renders each documented UI screen in a headless browser, diffs it against the screenshot currently embedded in your docs, and opens a Linear recapture task for every screen that drifted past a pixel threshold. Fresh screens are skipped, so reviewers only see real regressions.

When to use it

Run it on every web release when your published docs lean heavily on UI screenshots that silently rot the moment a layout, color, or label changes. It turns "someone will notice eventually" into a tracked queue the day the release lands.

How it works

  1. 1A GitHub release-published event fires the run with the new tag.
  2. 2The flow pulls the screenshot manifest (screen name to docs URL) from your ReadMe project.
  3. 3Browserbase loads each documented screen against the freshly deployed build and captures a current frame.
  4. 4A diff step scores each capture against the stored screenshot and keeps only those above the change threshold.
  5. 5For each drifted screen, a Linear issue is created with both images and the source doc link, tagged for the docs team.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect ReadMeAPI docs, changelog, auth.
  3. 3
    Connect BrowserbaseHeadless browsers, sessions, replays.
  4. 4
    Connect LinearIssues, projects, cycles, triage.
  5. 5
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  6. 6
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  7. 7
    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.