← Back

Docs

How Deploy Failures works.

What it is

Deploy Failures is a dashboard that visualizes how often your Vercel deployments have failed. It pulls failed deployments directly from the Vercel REST API and renders a stacked bar chart, summary stats, a clickable project legend, and a “Worst Days” table.

Getting started

  1. On the home page, click Continue with Vercel.
  2. Authorize the integration on a personal account or a team. Choose where it installs based on whose deployments you want to see.
  3. The dashboard loads with up to ~150 most recent failures, then fills in the long tail in the background (up to 5,000). Subsequent visits paint instantly from the local cache.

The dashboard

  • Time range togglein the chart header — 7d, 30d, 1y, or All. Numeric ranges longer than 120 days are bucketed weekly so the chart doesn't become razor-thin.
  • Legend below the chart. Click a row to isolate that project (only its bars render); click it again to show all. Each row has a thin colored bar showing its share of the total.
  • Worst Days table — top 10 days by failure count, all time. Bar width is relative to the worst day; bar segments show which projects contributed.
  • Trend chip next to the failure count — up arrow (red) means more failures than the previous equivalent window; down arrow (green) means fewer.

What it reads

Only the read-only scopes you grant at install time: deployment, project, team, user. No source code, no secrets, no build logs. Full details in the privacy policy.

Uninstalling

Click Uninstallin the top bar — this calls Vercel's integration-configuration delete endpoint, which invalidates the access token immediately. You can also uninstall from your Vercel dashboard's integrations page.

Open source

Source code, bug reports, and feature requests: github.com/bencered/deploy-failures. MIT licensed.