¿Qué es Vercel Doctor?
Reduce tu factura de Vercel escaneando tu código Next.js en busca de patrones costosos.
Vercel Doctor es una herramienta especializada de chequeo de salud para proyectos Next.js desplegados en Vercel. Escanea tu código en busca de patrones que inflan tu factura — duración de funciones, rutas sin caché, imágenes sin optimizar y más — y te da una puntuación de 0 a 100 con correcciones accionables. La guía se adapta a la versión mayor detectada de Next.js.
Inicio rápido
Ejecuta en tu proyecto
npx -y vercel-doctor@latest .Eso es todo. Sin instalación, sin configuración. Escanea tu código y genera una puntuación con diagnósticos.
Corrige los problemas
Cada diagnóstico incluye un mensaje de ayuda que explica qué cambiar y por qué. Corrige primero las reglas de mayor impacto — errores antes que advertencias.
Vuelve a ejecutar para verificar
npx -y vercel-doctor@latest . --diffUsa --diff en ramas de funcionalidades para escanear solo los archivos que modificaste.
Qué verifica
Vercel Doctor ejecuta dos pasadas de análisis en paralelo:
- Billing lint — reglas basadas en AST y patrones que detectan prácticas costosas de Next.js y Vercel
- Detección de código muerto — encuentra archivos, exportaciones y tipos no usados que inflan tu bundle y ralentizan los cold starts
Categorías de reglas
| Categoría | Rules | Qué detecta |
|---|---|---|
| Function Duration | 3 | Sequential awaits, blocking logging, non-parallel I/O |
| Caching | 6 | force-dynamic, missing cache policies, no-store fetches, side effects in GET handlers |
| Invocations | 2 | Client-side fetching in pages, aggressive link prefetching |
| Image Optimization | 4 | Global unoptimized, missing sizes, broad remote patterns, SVG without unoptimized |
| Platform | 8 | Edge heavy imports, cron jobs, Bun runtime, Fluid Compute, deploy archive, Turbopack cache |
| Dead Code | 4 | Unused files, exports, types, and duplicates |
Características
- Cero configuración — funciona de inmediato en cualquier proyecto Next.js
- Soporte monorepo — detecta automáticamente workspaces, permite elegir qué proyectos escanear
- Modo diff — escanea solo los archivos modificados en ramas de funcionalidades
- Puntuación — score de 0 a 100 con etiquetas Great / Needs work / Critical
- Compatible con CI — modo no interactivo para pipelines automatizados
- Configurable — ignora reglas o archivos mediante archivo de configuración
- Habilidad IA — instala como skill para Claude Code, Cursor, Codex y más
- Guía según la versión — las recomendaciones se ajustan a la versión mayor detectada de Next.js
Last updated on