DEVOPS

Performance budget gate blocking previews on Lighthouse regression

Runs a Lighthouse audit against each Vercel preview, compares core web vitals to production, and blocks promotion plus warns Slack when LCP, CLS, or the performance score regress…

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerwebhook
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerVercel preview deploy readyVercelVercel
  • ActionRun headless Lighthouse audit on previewShell
  • LogicBranch: web vitals regressed past budget?
  • ActionSet failing GitHub commit statusGitHubGitHub
  • OutputPost metric deltas to SlackSlack

What it does

This workflow enforces a performance budget on every preview before it can be promoted. It runs a headless Lighthouse audit against the preview URL, extracts core web vitals and the performance score, and compares them to the production baseline. Builds that regress beyond your tolerances are blocked, with the specific metric deltas reported.

When to use it

Use it when frontend performance keeps quietly degrading and nobody notices until users complain. It is ideal for marketing or storefront pages where a slow LCP directly costs conversions, and gives teams a hard, automated brake on shipping a heavier bundle.

How it works

  1. 1A Vercel preview-ready webhook triggers the run.
  2. 2A shell step runs Lighthouse headlessly against the preview URL and emits JSON.
  3. 3The metrics are compared against the stored production baseline for LCP, CLS, TBT, and score.
  4. 4A branch checks whether any metric regressed past its budget.
  5. 5If it did, a failing GitHub commit status blocks promotion.
  6. 6Slack gets a summary table of metric deltas and the verdict.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect VercelDeploys, runtime logs, analytics.
  2. 2
    Connect ShellRun sandboxed commands inside the workspace.
  3. 3
    Connect GitHubRepos, issues, pull requests, actions.
  4. 4
    Connect SlackChannels, DMs, threads, mentions.
  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.