DEVOPS

Post Lighthouse budget result as a GitHub PR status check

On each Vercel preview deploy tied to a pull request, runs Lighthouse and writes a required GitHub commit status that turns the merge button red until the performance budget…

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerwebhook
Steps4
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerVercel preview deployment ready for PRVercelVercel
  • ActionRun Lighthouse audit on preview URLBrowserbase
  • LogicEvaluate scores against budget
  • OutputWrite GitHub commit status check on the SHAGitHubGitHub

What it does

This turns your Lighthouse budget into a hard branch-protection gate. When a preview deploys for a PR, the workflow audits it and writes a GitHub commit status check; a failing budget marks the check red so the PR cannot be merged until performance is fixed, and a passing budget unblocks it.

When to use it

Use this when you want the QA gate enforced in GitHub itself rather than as a Slack notification. Pair it with a required status check in branch protection so a slow page literally cannot reach main.

How it works

  1. 1A Vercel deployment-ready webhook fires for a preview tied to a PR branch and commit SHA.
  2. 2A Lighthouse run audits the preview URL and captures category scores plus key metrics like LCP and TBT.
  3. 3A logic step decides pass or fail against your budget.
  4. 4The workflow posts a GitHub commit status (success or failure) on the exact SHA, with a target link to the report.
  5. 5The PR's required check reflects the result, gating the merge button automatically.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect VercelDeploys, runtime logs, analytics.
  2. 2
    Connect BrowserbaseHeadless browsers, sessions, replays.
  3. 3
    Connect GitHubRepos, issues, pull requests, actions.
  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.