Vercel Deployment Monitoring & Best Practices Audit for Home Assistant

Share your Projects! Custom Integrations
1

Vercel Deployment Monitoring & Best Practices Audit for Home Assistant

Hi everyone!

I’ve built a custom integration that brings your Vercel deployment pipeline into Home Assistant. If you use Vercel to host your web apps, you can now monitor everything from your HA dashboard.

Dashboard Screenshot
Dashboard Screenshot3840×1864 330 KB

What it does

  • Deployment monitoring — real-time status of your latest deployments (ready, building, error, queued) with 60-second polling. Includes build duration, deployment URL, commit message, and source (git/cli/redeploy).
  • Project health — framework detection, Node.js version, active deployment count, and 24-hour failure count per project.
  • Domain health — binary sensors that report domain connectivity, SSL validity, and DNS misconfiguration for every domain in your account.
  • Best practices audit — each project gets a score from 0–100% based on six automated checks (framework detection, modern Node.js, env var hygiene, error rate, rollback availability, deployment freshness). Issues are exposed as entity attributes so you can automate alerts.
  • Account-level sensors — total projects and domains across your account or team.
  • Team support — works with personal accounts or any team your API token has access to.

Example automations

  • Get notified when a deployment fails
  • Alert when a project’s best practices score drops below a threshold
  • Track build duration trends over time with the HA history graph
  • Monitor domain SSL/DNS health and get alerted on misconfiguration

Installation

HACS (custom repository for now)

  1. Open HACS → Integrations → three-dot menu → Custom repositories
  2. Add: https://github.com/Nathanowen3225/ha-vercel
  3. Category: Integration → Add
  4. Search “Vercel” → Install → Restart HA

Setup

  1. Go to Settings → Devices & services → Add integration → Vercel
  2. Enter your Vercel API token (create one here)
  3. Select your team (or personal account)
  4. Devices are created automatically for each project and domain

Tip: Create a read-only scoped token. The integration never modifies your Vercel resources.

Links

Feedback, bug reports, and feature requests are very welcome. This is v0.1.0 so I’d love to hear what’s useful and what’s missing.

Thanks!