DEVOPS

Crawl Vercel preview for broken links and a11y violations before promote

Crawls a Vercel preview deployment for broken internal links and accessibility violations, and blocks promotion to production while filing a Linear ticket for each defect found.

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerwebhook
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerVercel preview deployment readyVercelVercel
  • ActionCrawl preview for broken linksFirecrawl
  • ActionRun accessibility scan on pagesShell
  • LogicAny broken links or a11y violations?
  • OutputFile Linear ticket per defectLinearLinear

What it does

This workflow does a content-integrity sweep of each preview before it can ship. It crawls the preview site, following internal links to find 4xx/5xx pages, and runs an automated accessibility scan on each page. If it finds broken links or serious a11y violations it keeps the deployment unpromoted and opens a tracked defect for each issue so nothing gets lost.

When to use it

Use it on marketing or docs sites where dead links and accessibility regressions are common and you want them caught and ticketed automatically rather than discovered by users.

How it works

  1. 1A Vercel preview-ready webhook provides the preview URL and deployment ID.
  2. 2A Firecrawl step crawls the preview site and returns the link graph with HTTP status codes per page.
  3. 3A shell step runs an axe-core accessibility scan on the crawled pages and emits violations.
  4. 4A logic branch checks whether any broken links or critical a11y violations exist.
  5. 5If clean, an action promotes the deployment on Vercel. If not, it stays unpromoted and a Linear issue is created per defect with the page URL and details.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect VercelDeploys, runtime logs, analytics.
  2. 2
    Connect FirecrawlCrawl, scrape, structured extract.
  3. 3
    Connect ShellRun sandboxed commands inside the workspace.
  4. 4
    Connect LinearIssues, projects, cycles, triage.
  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.