Com um plano de Apps Node.js você publica apps Node (Express, Fastify, NestJS, Next.js e mais) direto do seu repositório. Nós instalamos as dependências, rodamos o build e iniciamos a app.
Passo a passo
- Entre em Apps Node.js no seu painel e clique em Criar app no seu plano.
- Escolha Repositório Git e cole o endereço HTTPS (por exemplo https://github.com/usuario/minha-api). Informe a branch a implantar (normalmente main).
- Se o repositório for privado, marque É um repositório privado e cole um token somente leitura (veja abaixo como criar).
- Em Build e execução escolha a versão do Node (20, 22 ou 24). Os comandos são opcionais: se ficarem vazios, detectamos pelo seu package.json e gerenciador (npm, pnpm ou yarn).
- Adicione suas variáveis de ambiente (ou cole seu .env) e escolha o nome e o endereço: sua app fica em https://sua-app.apps.fodenflow.com.
- Clique em Criar e implantar e acompanhe o log do build ao vivo. Quando terminar, a app está no ar.
O que sua app precisa
- Escutar na porta da variável PORT (por exemplo app.listen(process.env.PORT)).
- Ter um comando de início: o script start do package.json ou o que você definir em Iniciar.
- Responder no caminho de verificação (/ por padrão): verificamos antes de mandar visitas para uma versão nova.
Como criar um token do GitHub (repositório privado)
- No GitHub: Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token.
- Em Repository access escolha Only select repositories e marque o repositório.
- Em Permissions → Contents escolha Read-only. Gere o token e cole no painel.
No GitLab use um Access Token do projeto com read_repository; no Bitbucket, um Access Token do repositório com Repositories: Read. O token é guardado criptografado e não é mostrado de novo.
Não usa Git? Você também pode enviar um ZIP do projeto (até 200 MB, sem node_modules) ou começar com um modelo que já funciona.
Pergunte ao assistente
Ficou alguma dúvida sobre isso? Pergunte ao assistente.
Este artigo ajudou?
Artigos relacionados
- Variáveis de ambiente da sua app Node.jsChaves de API, senhas e configurações que sua app lê com process.env, criptografadas e com valores secretos.
- Deploys automáticos e voltar para uma versão anteriorCada push publica uma versão nova sem quedas; se algo der errado, você volta para a anterior em um clique.
- Usar seu domínio em uma app Node.js (com SSL)Adicione seu domínio, crie um registro A ou CNAME e emitimos o certificado do Let's Encrypt automaticamente.