Gerador railway.toml

Na Railway dá para configurar tudo pelo painel, só que aí a configuração vive fora do repositório: ninguém revisa em pull request e cada ambiente novo nasce um pouco diferente. O railway.toml guarda etapa de build, comando de start e healthcheck junto do código. Esta página entrega um arquivo desses já preenchido, com Nixpacks, npm run build, npm start e política de restart.

A saída é fixa e não tem formulário: o texto aparece quando a página carrega e o botão apenas o imprime de novo. O detalhe que importa é a precedência. O que está no railway.toml vale mais do que o que você configurou no painel, então, depois de comitar esse arquivo, mudar o comando de start pela interface deixa de ter efeito. Isso pega muita gente no primeiro deploy.

Antes de comitar, garanta que existe uma rota /health respondendo 200. Se ela não existir, a Railway espera os 100 segundos de healthcheckTimeout, marca o deploy como falho e mantém a versão anterior no ar. Se o projeto não tem etapa de build, apague o buildCommand em vez de deixar um npm run build inexistente. Com Dockerfile na raiz, troque o builder para DOCKERFILE. O arquivo é montado no navegador.