Applications Node.js, Next.js et Nuxt.
Comment les projets Node.js sont détectés et démarrés : version de Node, gestionnaire de paquets, Next.js et Nuxt (serveur ou statique), SvelteKit, Astro, Express et consorts, la variable PORT et les migrations Prisma.
Un dépôt qui contient un package.json est un projet Node.js. Nous choisissons le framework, le gestionnaire de paquets et la version de Node, puis nous construisons et démarrons l'application : vous n'avez qu'à pousser votre code.
Version de Node et gestionnaire de paquets
- Node.js — d'après
engines.nodedanspackage.jsonou d'après.nvmrc: la plus récente des versions 24, 22, 20, 18 ou 16 qui convient. Sans l'un ni l'autre, Node.js 22. - Gestionnaire de paquets — d'après le fichier de verrouillage :
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, sinon npm (npm cis'il y a unpackage-lock.json). - Build — le script
build, sipackage.jsonen contient un.
Frameworks
| Framework | Mode d'exécution |
|---|---|
| Next.js | en serveur (next start) — le rendu côté serveur, les routes API et le middleware fonctionnent normalement |
Next.js avec output: 'export' | en site statique depuis out |
| Nuxt | en serveur (.output/server/index.mjs) |
Nuxt avec ssr: false et un script generate | en site statique depuis .output/public |
| SvelteKit | en serveur avec adapter-node ; avec adapter-static, en site statique |
| Astro | en site statique ; avec @astrojs/node, en serveur |
| NestJS | dist/main.js après le build |
| Express, Fastify, Koa, Hono et autres serveurs | le fichier indiqué dans scripts.start (node server.js), sinon main, sinon server.js, app.js, index.js ou main.js |
Les projets uniquement front-end — Vite, Create React App, Angular, Vue CLI et d'autres — sont servis comme des sites statiques ; voir Sites statiques.
Écouter sur PORT
Un serveur doit écouter sur le port indiqué dans la variable PORT, sur toutes les interfaces :
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js et Nuxt le font d'eux-mêmes. Si votre application écoute sur un port fixe, elle ne recevra aucun visiteur : le déploiement s'arrête alors à la vérification de démarrage, et la version précédente continue de tourner.
Valeurs utilisées au build
Les variables de l'onglet Variables arrivent dans l'application en cours d'exécution, pas dans le build. Les valeurs que le build inscrit dans le code client — comme NEXT_PUBLIC_… dans Next.js ou VITE_… — sont lues depuis votre dépôt, par exemple depuis un fichier .env.production commité. Le code côté serveur lit l'onglet Variables comme d'habitude.
Votre propre commande de démarrage
Si le démarrage détecté ne vous convient pas, renseignez Paramètres → Paramètres de build → Commande de démarrage, par exemple node dist/server.js ou npm run start:prod. Les commandes d'installation et de build peuvent aussi être modifiées à cet endroit.
Bases de données et Prisma
Ajoutez PostgreSQL ou MySQL au projet et lisez DATABASE_URL : cette variable est définie pour vous. Si Prisma fait partie de vos dépendances, la commande de publication recommandée est npx prisma migrate deploy : elle s'exécute à chaque déploiement, avant que la nouvelle version reçoive des visiteurs. Voir Déploiements.
Pour des files d'attente avec BullMQ, ajoutez Valkey et utilisez REDIS_URL. Faites tourner le worker de la file comme worker en arrière-plan — dans l'onglet Processus, ou comme service séparé avec ses propres ressources. Voir Services d'un projet.
Fichiers conservés d'un déploiement à l'autre
Chaque déploiement part d'une copie neuve de votre dépôt. Les fichiers que votre application écrit dans /data sont conservés entre les déploiements et sauvegardés chaque jour ; tout ce qui est écrit ailleurs disparaît au déploiement suivant. Pour les fichiers envoyés et les médias, le stockage objet est généralement le meilleur choix.
Monorepos
Pour un dépôt qui contient plusieurs projets, indiquez le Dossier du projet lors de la création de l'application (par exemple apps/web). Un autre dossier du même dépôt peut tourner comme service web séparé — voir Services d'un projet.