O que é o Vercel Doctor?
Reduza sua conta da Vercel escaneando seu código Next.js em busca de padrões custosos.
Vercel Doctor é uma ferramenta especializada de verificação de saúde para projetos Next.js implantados na Vercel. Ele escaneia seu código em busca de padrões que inflam sua conta — duração de funções, rotas sem cache, imagens não otimizadas e mais — e então atribui uma pontuação de 0 a 100 com correções práticas. 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 .É só isso. Sem instalação, sem configuração. Ele escaneia seu código e retorna uma pontuação com diagnósticos.
Corrija os problemas
Cada diagnóstico inclui uma mensagem de ajuda explicando o que mudar 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 feature para escanear apenas os arquivos que você alterou.
O que ele verifica
O Vercel Doctor executa duas passagens de análise em paralelo:
- Lint de faturamento — regras baseadas em AST e padrões que detectam padrões custosos do Next.js e Vercel
- Detecção de código morto — encontra arquivos, exports e tipos não utilizados que aumentam o bundle e atrasam os cold starts
Categorias de regras
| Categoria | Regras | O que detecta |
|---|---|---|
| Duração de Funções | 3 | Awaits sequenciais, logging bloqueante, I/O não paralelo |
| Cache | 6 | force-dynamic, políticas de cache ausentes, fetches no-store, efeitos colaterais em handlers GET |
| Invocações | 2 | Fetch no lado do cliente em páginas, prefetching agressivo de links |
| Otimização de Imagens | 4 | unoptimized global, sizes ausente, padrões remotos amplos demais, SVG sem unoptimized |
| Plataforma | 8 | Imports pesados no Edge, cron jobs, runtime Bun, Fluid Compute, arquivo de deploy, cache Turbopack |
| Código Morto | 4 | Arquivos, exports, tipos não utilizados e duplicados |
Funcionalidades
- Zero configuração — funciona imediatamente em qualquer projeto Next.js
- Suporte a monorepo — detecta automaticamente workspaces, permite escolher quais projetos escanear
- Modo diff — escaneia apenas arquivos alterados em branches de feature
- Pontuação — pontuação de 0–100 com rótulos Ótimo / Precisa melhorar / Crítico
- Compatível com 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