1001Ferramentas
🌐Dev

Gerador netlify.toml

Gere um netlify.toml com comando de build, redirects e cabeçalhos de segurança prontos para o deploy na Netlify. Configure tudo pelo navegador e copie o arquivo.



  

netlify.toml com fallback de SPA e cabeçalhos

Toda single-page app bate na mesma parede na Netlify: você abre /dashboard direto pela barra de endereço e leva 404, porque esse arquivo não existe no disco e quem resolve a rota é o JavaScript. A correção é um rewrite para /index.html com status 200. Este gerador entrega um netlify.toml que já traz essa regra, o comando de build e três cabeçalhos de segurança.

A saída é fixa: nenhum campo para preencher, o TOML aparece assim que a página carrega e o botão reimprime o mesmo texto. Repare no status 200 do redirect, em vez de 301 ou 302. Com 200, a Netlify serve o index.html enquanto a URL permanece na barra, que é exatamente do que o roteador do lado do cliente precisa. Arquivos que existem de verdade continuam sendo servidos antes da regra.

Ajuste o publish antes de subir: dist bate com Vite e Astro, mas Create React App gera build. Se o repositório já tem um _redirects em public, saiba que ele é avaliado antes das regras do netlify.toml, e manter os dois costuma confundir. Em site com rotas de servidor, o rewrite catch-all atrapalha mais do que ajuda, então apague esse bloco. Nada sai do seu navegador durante a geração.

Perguntas frequentes

Posso mudar a pasta publicada pela ferramenta?
Não há campo para isso; o arquivo sai sempre com publish = dist. Edite essa linha para a pasta que o seu build realmente produz.
O rewrite /* quebra as minhas imagens e o CSS?
Não. A Netlify entrega arquivos existentes antes de aplicar a regra, então ela só entra quando o caminho não corresponde a nenhum arquivo publicado.
Dá para acrescentar Content-Security-Policy?
Dá, à mão: some uma linha dentro de [headers.values]. O arquivo gerado traz apenas X-Frame-Options, X-Content-Type-Options e Referrer-Policy.

Ferramentas Relacionadas