Vercel passa a aceitar configuração de projetos com vercel.toml
Aprofundamento CEVIU
Aprofundamento
A Vercel passou a aceitar o vercel.toml como arquivo de configuração de projeto, no formato TOML. Todas as propriedades do vercel.json continuam valendo. O que muda é a sintaxe: TOML aceita comentários e tem uma estrutura mais plana. Todos os projetos já podem usar o recurso.
A regra é manter só um arquivo de configuração por projeto: vercel.toml, vercel.json ou vercel.ts. O exemplo do changelog mostra a configuração de Services. Há um frontend em NextJS com root em frontend/ e um backend em FastAPI com root em backend/ e entrypoint main:app. Duas regras de rewrites fazem o roteamento: /api/(.*) vai para o serviço backend e /(.*) vai para o serviço frontend. O arquivo também aponta o $schema para o esquema do vercel.json.
O que mudou
Em 1 de julho de 2026, o CEVIU noticiou "Execute múltiplos frameworks em um único projeto com o Vercel Services", sobre rodar vários frameworks em um mesmo projeto. O exemplo atual usa esse recurso: dois serviços (NextJS e FastAPI) no mesmo projeto, agora descritos em TOML. Em 22 de outubro de 2026, o CEVIU noticiou "Routing Middleware da Vercel agora roda com Python", que também envolve FastAPI. A novidade de hoje não muda o que a plataforma executa, só oferece outro formato para declarar a configuração.
Por que isso importa
Para quem mantém configurações longas de Services e rewrites, poder comentar o arquivo ajuda a documentar por que cada regra existe. Quem já tem vercel.json não precisa migrar, mas deve evitar manter dois arquivos no mesmo projeto, já que a regra pede apenas um.
Linha do tempo
Vercel Services permite rodar múltiplos frameworks em um único projeto.
Routing Middleware da Vercel passa a rodar com Python.
Vercel passa a aceitar configuração de projetos com vercel.toml.
Perguntas frequentes
O que é o vercel.toml?
É um arquivo de configuração de projeto da Vercel no formato TOML. Aceita as mesmas propriedades do vercel.json, com suporte a comentários e estrutura mais plana.
Preciso migrar meu vercel.json para vercel.toml?
Não. O vercel.json continua suportado com todas as propriedades. A regra é usar apenas um arquivo de configuração por projeto, entre vercel.toml, vercel.json ou vercel.ts.
Quais projetos podem usar o vercel.toml?
Todos os projetos já podem usar. O lançamento está disponível oficialmente, segundo o changelog da Vercel.
Como o vercel.toml configura Services?
No exemplo do changelog, cada serviço ganha uma seção, como services.frontend com root frontend/ e services.backend com root backend/ e entrypoint main:app. Depois, regras de rewrites mandam /api/(.*) para o backend e /(.*) para o frontend.
Fontes
- vercel.comfonte original
- Categoria
- CEVIU Web Dev
- Publicado
- 03 de novembro de 2026
- Editoria
- CEVIU Web Dev

