DEVOPS

Vercel Preview Browser E2E Gate

Drives a headless browser through a critical user journey on each new Vercel preview deployment, captures screenshots of every step.

CategoryDevOps
Enginesim
Difficultyadvanced
Triggerwebhook
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerVercel preview deployment succeededVercelVercel
  • LogicFilter to preview builds on an open PR
  • ActionRun scripted browser journey with screenshotsBrowserbase
  • LogicFail run if any step errors or asserts false
  • OutputSet commit status and post screenshot checklist to PRGitHubGitHub

What it does

Runs a real browser end-to-end flow against a fresh Vercel preview, not just an HTTP ping. Browserbase loads the preview URL, clicks through a critical journey (sign in, open dashboard, submit the core form), and screenshots each step. The pass/fail outcome and screenshot links land on the pull request so reviewers see exactly what the bot saw.

When to use it

Use it for apps where the risk lives in client-side rendering and interaction, not just status codes, such as auth flows, multi-step forms, or single-page apps where a 200 hides a broken UI.

How it works

  1. 1Vercel sends a deployment-succeeded webhook with the preview URL and commit SHA.
  2. 2A filter keeps only preview deployments attached to an open pull request.
  3. 3Browserbase launches a session, walks the scripted journey on the preview URL, and grabs a screenshot at each checkpoint.
  4. 4Logic marks the run failed if any step times out or an assertion misses.
  5. 5GitHub receives a commit status plus a PR comment linking the step-by-step screenshots, gating merge on a clean run.

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.