Começar

Aplicações Node.js, Next.js e Nuxt.

Como os projetos Node.js são detetados e arrancados: versão do Node, gestor de pacotes, Next.js e Nuxt (servidor ou estático), SvelteKit, Astro, Express e afins, a variável PORT e as migrações do Prisma.

3 MIN DE LEITURA

Um repositório com um package.json é um projeto Node.js. Escolhemos a framework, o gestor de pacotes e a versão do Node, compilamos e arrancamos a aplicação — só tem de fazer push.

Versão do Node e gestor de pacotes

  • Node.js — lida de engines.node no package.json ou do .nvmrc: a mais recente de 24, 22, 20, 18 ou 16 que encaixe. Sem nenhum dos dois, Node.js 22.
  • Gestor de pacotes — pelo ficheiro de lock: pnpm-lock.yaml → pnpm, yarn.lock → yarn, caso contrário npm (npm ci quando existe um package-lock.json).
  • Compilação — o script build, quando o package.json o tem.

Frameworks

FrameworkComo corre
Next.jscomo servidor (next start) — a renderização no servidor, as rotas de API e o middleware funcionam como habitualmente
Next.js com output: 'export'como site estático a partir de out
Nuxtcomo servidor (.output/server/index.mjs)
Nuxt com ssr: false e um script generatecomo site estático a partir de .output/public
SvelteKitcomo servidor com adapter-node; com adapter-static, como site estático
Astrocomo site estático; com @astrojs/node, como servidor
NestJSdist/main.js depois da compilação
Express, Fastify, Koa, Hono e outros servidoreso ficheiro em scripts.start (node server.js), senão main, senão server.js, app.js, index.js ou main.js

Os projetos só de front-end — Vite, Create React App, Angular, Vue CLI e outros — são servidos como sites estáticos; consulte Sites estáticos.

Escutar na PORT

Um servidor tem de escutar na porta indicada na variável PORT, em todas as interfaces:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

O Next.js e o Nuxt fazem-no sozinhos. Se a sua aplicação escutar numa porta fixa, não recebe visitantes — a publicação para então na verificação de arranque e a versão anterior continua a funcionar.

Valores no momento da compilação

As variáveis do separador Variáveis chegam à aplicação em execução, não à compilação. Os valores que a compilação escreve no código do cliente — como NEXT_PUBLIC_… no Next.js ou VITE_… — são lidos do seu repositório, por exemplo de um ficheiro .env.production incluído no commit. O código do lado do servidor lê o separador Variáveis como habitualmente.

O seu próprio comando de arranque

Se o arranque detetado não for o que pretende, defina Definições → Definições de compilação → Comando de arranque, por exemplo node dist/server.js ou npm run start:prod. Também pode alterar aí os comandos de instalação e de compilação.

Bases de dados e Prisma

Adicione PostgreSQL ou MySQL ao projeto e leia DATABASE_URL — é definida por nós. Com o Prisma nas dependências, o comando de lançamento recomendado é npx prisma migrate deploy: corre em cada publicação, antes de a nova versão receber visitantes. Consulte Publicações.

Para filas com BullMQ, adicione o Valkey e use REDIS_URL. Corra o worker da fila como worker em segundo plano — no separador Processos, ou como serviço separado com os seus próprios recursos. Consulte Serviços de um projeto.

Ficheiros que sobrevivem a uma publicação

Cada publicação parte de uma cópia nova do seu repositório. Os ficheiros que a aplicação escreve em /data mantêm-se entre publicações e têm backup diário; tudo o que for escrito noutro sítio desaparece na publicação seguinte. Para uploads e multimédia, o armazenamento de objetos costuma ser a melhor opção.

Monorepos

Num repositório com vários projetos, defina a Pasta do projeto ao criar a aplicação (por exemplo, apps/web). Outra pasta do mesmo repositório pode correr como serviço web separado — consulte Serviços de um projeto.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte