Voltar
Vercel passa a aceitar configuração de projetos com vercel.toml

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

  1. Vercel Services permite rodar múltiplos frameworks em um único projeto.

  2. Routing Middleware da Vercel passa a rodar com Python.

  3. 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

Avalie este artigo:
Categoria
CEVIU Web Dev
Publicado
03 de novembro de 2026
Editoria
CEVIU Web Dev

Quer receber mais sobre CEVIU Web Dev?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser