DEVOPS

Block Vercel promotion until Lighthouse budgets pass

When a Vercel preview deployment finishes, runs Lighthouse against the preview URL and only promotes the build to production if performance, accessibility, and SEO scores clear…

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 URLShell
  • LogicAll category scores meet budgets?
  • ActionPromote deployment to productionVercelVercel
  • OutputPost failing scores to SlackSlack

What it does

This workflow turns every Vercel preview deploy into a hard quality gate. As soon as a preview is ready, it audits the live preview URL with Lighthouse, compares each category score against thresholds you set, and decides whether the build is allowed to be promoted to production. Failing builds are stopped and the offending scores are reported so the author can fix them before they ship.

When to use it

Use it when you want objective, automatic performance and accessibility enforcement on a Next.js or static site hosted on Vercel, instead of relying on developers to remember to run Lighthouse by hand.

How it works

  1. 1A Vercel deployment-ready webhook fires with the preview URL and deployment ID.
  2. 2A shell step runs Lighthouse CI against the preview URL and emits the category scores as JSON.
  3. 3A logic branch checks each score (performance, accessibility, best-practices, SEO) against your minimums.
  4. 4If all pass, an action calls the Vercel API to promote the deployment to production.
  5. 5If any fail, a Slack message reports the failing categories, scores, and preview link to the channel — the build stays unpromoted.

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 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.