1001Ferramentas
Dev

Gerador vercel.json

Crie um vercel.json com rotas, redirects e cabeçalhos HTTP prontos para o deploy na Vercel. Configure tudo pelo navegador e cole no seu repositório.



  

Exemplo de vercel.json, com uma ressalva

Publicar um app Express na Vercel não é como subir site estático: a plataforma precisa saber qual arquivo é a função serverless e para onde mandar todas as rotas. Esta página mostra um vercel.json exatamente nesse formato, com build @vercel/node apontando para src/app.js, uma rota catch-all e dois cabeçalhos de segurança básicos já preenchidos.

Leia isto antes de copiar. O arquivo gerado traz routes e headers ao mesmo tempo, e a Vercel recusa essa combinação com erro de propriedades de roteamento misturadas. O routes é a sintaxe antiga e, sempre que aparece, não pode conviver com headers, redirects, rewrites, cleanUrls ou trailingSlash. Trate a saída como ponto de partida, não como arquivo final pronto para o deploy.

O caminho moderno é apagar o bloco routes e escrever a mesma intenção com rewrites, usando source e destination, mantendo headers como está. Em geral também dá para remover o builds inteiro e deixar a Vercel detectar o projeto, o que rende menos surpresa com framework conhecido. A página não tem campos: o JSON é fixo e montado no seu navegador, então ajuste os caminhos ao seu repositório.

Perguntas frequentes

O arquivo gerado funciona como está?
Não sem edição. Misturar routes com headers faz a Vercel recusar a configuração; troque routes por rewrites e o deploy passa.
Preciso do bloco builds?
Na maioria dos projetos, não. A Vercel detecta framework e runtime sozinha, e builds é herança da versão 2 que desliga essa detecção.
Dá para escolher os cabeçalhos na página?
Não. Saem sempre X-Frame-Options: DENY e X-Content-Type-Options: nosniff. Adicionar CSP ou HSTS é editar o array depois de colar.

Ferramentas Relacionadas