DEVOPS

Block Vercel promotion when Lighthouse budgets fail

When a Vercel preview deployment finishes, runs Lighthouse against the preview URL and blocks promotion to production if any performance, accessibility, or SEO budget is breached.

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerwebhook
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerVercel preview deployment readyVercelVercel
  • ActionRun Lighthouse audit on preview URLBrowserbase
  • LogicCompare scores to budget thresholds
  • ActionTag deployment promotable or held in VercelVercelVercel
  • OutputPost pass/fail verdict to SlackSlack

What it does

Every Vercel preview deploy is automatically scored against a Lighthouse budget you define. If the build clears every threshold it is marked promotable; if any category falls short, the workflow flags the deployment as blocked and reports the exact failing metrics to your release channel so nobody ships a regression by accident.

When to use it

Use this when your team treats Vercel previews as the last gate before production and you want an objective, repeatable performance bar instead of eyeballing PageSpeed. Ideal for marketing sites and dashboards where Core Web Vitals directly affect conversion or SEO.

How it works

  1. 1A Vercel deployment-ready webhook fires with the preview URL and commit SHA.
  2. 2A Lighthouse run (headless Chrome) audits the preview URL for performance, accessibility, best-practices, and SEO scores.
  3. 3A logic step compares each score against the configured budget thresholds.
  4. 4If all pass, the deployment is tagged promotable in Vercel; if any fail, promotion is held.
  5. 5A Slack message posts the pass/fail verdict, the failing categories, and a link to the full report.

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 SlackChannels, DMs, threads, mentions.
  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.