Vercel CLI agora permite realizar deploys em modo dry-run

A Vercel CLI lançou oficialmente o modo dry-run para deploys em 1º de julho de 2026, conforme anunciado por Melkey Moksyakov e registrado no changelog da empresa em 30 de junho de 2026. O comando vercel deploy --dry mostra, antes de qualquer upload, o preset do framework detectado (como Next.js ou Nuxt), a contagem e o tamanho total dos arquivos incluídos, os caminhos ignorados via .vercelignore, e os maiores arquivos com seus tamanhos exatos. A saída é otimizada para leitura humana em terminal, mas muda automaticamente para JSON em ambientes não interativos, como CI/CD, garantindo consistência em automações.

Com vercel deploy --dry --format=json, o manifesto completo expõe dados técnicos precisos: modos de arquivo (ex.: 0644), hashes SHA-256 dos conteúdos, distribuição de tamanho por diretório e listas explícitas de paths incluídos e excluídos. Isso permite que agentes verifiquem, por exemplo, se um arquivo sensível foi acidentalmente deixado de fora do .vercelignore, ou se um asset está acima de 5 MB, sem gerar um deployment real nem consumir quota de build.

O dry-run resolve um problema antigo em pipelines modernos: a falta de visibilidade pré-upload. Antes, devs só descobriam erros de configuração (framework mal detectado, arquivos faltando ou extras) após o deploy falhar, com tempo de espera, consumo de quota e risco de impacto em ambientes de staging ou produção. Agora, é possível validar a integridade do pacote de deploy localmente ou em CI, com zero custo operacional. Isso reduz retrabalho, aumenta confiança em mudanças de infraestrutura e alinha com práticas de shift-left testing em engenharia de software.

Não é só sobre segurança ou economia: é sobre previsibilidade. Um manifesto JSON reprodutível permite comparar versões de deploy entre branches, auditar mudanças de conteúdo entre releases e integrar verificações automatizadas em políticas de compliance, tudo antes de um único byte ser enviado para a nuvem da Vercel.

Para devs e equipes de infra, o dry-run transforma o vercel deploy de um comando de execução em uma ferramenta de diagnóstico. Basta atualizar para a CLI v54.17.2 ou superior, disponível desde 30 de junho de 2026, e usar --dry como etapa obrigatória em scripts de release. Em CI, é comum adicionar um step como vercel deploy --dry --format=json | jq '.fileCount > 500' para bloquear builds com excesso de arquivos. Também facilita a depuração de problemas de detecção de framework: se o output mostra Framework: unknown, o problema está na estrutura do projeto, não no deploy em si.

Não há mudança na forma como projetos são configurados: o dry-run respeita todas as regras existentes (vercel.json, .vercelignore, next.config.js). Ele apenas expõe o que já seria usado, agora de forma transparente e auditável. É uma evolução silenciosa, mas com impacto direto na confiabilidade do ciclo de deploy.