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.
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.nodenopackage.jsonou 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 ciquando existe umpackage-lock.json). - Compilação — o script
build, quando opackage.jsono tem.
Frameworks
| Framework | Como corre |
|---|---|
| Next.js | como 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 |
| Nuxt | como servidor (.output/server/index.mjs) |
Nuxt com ssr: false e um script generate | como site estático a partir de .output/public |
| SvelteKit | como servidor com adapter-node; com adapter-static, como site estático |
| Astro | como site estático; com @astrojs/node, como servidor |
| NestJS | dist/main.js depois da compilação |
| Express, Fastify, Koa, Hono e outros servidores | o 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.