O que é o Vercel Doctor?
Reduza sua fatura da Vercel escaneando sua base de código Next.js em busca de padrões custosos.
O Vercel Doctor é uma ferramenta especializada de verificação de saúde para projetos Next.js implantados na Vercel. Ele escaneia sua base de código em busca de padrões que inflam sua fatura — duração de funções, rotas não cacheadas, imagens não otimizadas e mais — e fornece uma pontuação de 0 a 100 com correções acionáveis. A orientação se ajusta à versão major detectada do Next.js.
Início rápido
Execute no seu projeto
npx -y vercel-doctor@latest .Pronto. Sem instalação, sem configuração. Ele escaneia sua base de código e retorna uma pontuação com diagnósticos.
Corrija os problemas
Cada diagnóstico inclui uma mensagem de ajuda explicando o que alterar e por quê. Corrija primeiro as regras de maior impacto — erros antes de avisos.
Execute novamente para verificar
npx -y vercel-doctor@latest . --diffUse --diff em branches de funcionalidades para escanear apenas os arquivos alterados.
O que ele verifica
O Vercel Doctor executa duas passagens de análise em paralelo:
- Billing lint — Regras baseadas em AST e padrões que detectam padrões custosos de Next.js e Vercel
- Detecção de código morto — encontra arquivos, exports e tipos não utilizados que inflam seu bundle e atrasam cold starts
Categorias de regras
| Category | Rules | What it catches |
|---|---|---|
| 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 |
Recursos
- Zero config — funciona out-of-the-box em qualquer projeto Next.js
- Suporte a monorepo — detecta workspaces automaticamente, permite escolher quais projetos escanear
- Modo diff — escaneie apenas arquivos alterados em branches de funcionalidades
- Pontuação — score de 0–100 com labels Great / Needs work / Critical
- Amigável a CI — modo não interativo para pipelines automatizados
- Configurável — ignore regras ou arquivos via arquivo de configuração
- Skill de IA — instale como skill para Claude Code, Cursor, Codex e mais
- Orientação por versão — as recomendações se ajustam à versão major detectada do Next.js
Last updated on