Застосунки на Node.js, Next.js і Nuxt.
Як ми розпізнаємо й запускаємо проєкти на Node.js: версія Node, менеджер пакетів, Next.js і Nuxt (сервер або статика), SvelteKit, Astro, Express та інші, змінна PORT і міграції Prisma.
Репозиторій із файлом package.json — це проєкт на Node.js. Ми самі визначаємо фреймворк, менеджер пакетів і версію Node, збираємо й запускаємо проєкт — вам лишається тільки робити push.
Версія Node і менеджер пакетів
- Node.js — береться з
engines.nodeуpackage.jsonабо з.nvmrc: найновіша з 24, 22, 20, 18 чи 16, що підходить. Якщо немає ні того, ні іншого, — Node.js 22. - Менеджер пакетів — за lock-файлом:
pnpm-lock.yaml→ pnpm,yarn.lock→ yarn, інакше npm (npm ci, якщо єpackage-lock.json). - Збирання — скрипт
build, якщо він є вpackage.json.
Фреймворки
| Фреймворк | Як запускається |
|---|---|
| Next.js | як сервер (next start) — серверний рендеринг, API-маршрути й middleware працюють як завжди |
Next.js з output: 'export' | як статичний сайт із out |
| Nuxt | як сервер (.output/server/index.mjs) |
Nuxt з ssr: false і скриптом generate | як статичний сайт із .output/public |
| SvelteKit | як сервер з adapter-node; з adapter-static — як статичний сайт |
| Astro | як статичний сайт; з @astrojs/node — як сервер |
| NestJS | dist/main.js після збирання |
| Express, Fastify, Koa, Hono та інші сервери | файл зі scripts.start (node server.js), інакше main, інакше server.js, app.js, index.js або main.js |
Проєкти лише з фронтендом — Vite, Create React App, Angular, Vue CLI та інші — обслуговуються як статичні сайти; див. Статичні сайти.
Слухайте порт із PORT
Сервер має слухати порт зі змінної PORT на всіх інтерфейсах:
const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')Next.js і Nuxt роблять це самі. Якщо ваш застосунок слухає фіксований порт, відвідувачі до нього не потраплять — тоді розгортання зупиниться на перевірці запуску, а попередня версія продовжить працювати.
Значення на етапі збирання
Змінні з вкладки Змінні потрапляють у запущений застосунок, а не в збирання. Значення, які збирання вписує в клієнтський код, — як-от NEXT_PUBLIC_… у Next.js або VITE_…, — читаються з вашого репозиторію, наприклад із закоміченого файлу .env.production. Серверний код читає вкладку Змінні як звичайно.
Власна команда запуску
Якщо визначений нами спосіб запуску вам не підходить, задайте Налаштування → Налаштування збирання → Команда запуску, наприклад node dist/server.js або npm run start:prod. Там само можна змінити команди встановлення й збирання.
Бази даних і Prisma
Додайте до проєкту PostgreSQL або MySQL і читайте DATABASE_URL — цю змінну задано за вас. Якщо в залежностях є Prisma, рекомендована команда релізу — npx prisma migrate deploy: вона виконується під час кожного розгортання, перш ніж нова версія почне приймати відвідувачів. Див. Розгортання.
Для черг на BullMQ додайте Valkey і використовуйте REDIS_URL. Обробник черги запускайте як фоновий процес — на вкладці Процеси або як окремий сервіс із власними ресурсами. Див. Сервіси проєкту.
Файли, що переживають розгортання
Кожне розгортання починається зі свіжої копії вашого репозиторію. Файли, які застосунок записує в /data, зберігаються між розгортаннями, і щодня з них робиться резервна копія; усе, що записано деінде, зникне після наступного розгортання. Для завантажень і медіафайлів зазвичай краще підходить об’єктне сховище.
Монорепозиторії
Якщо в репозиторії кілька проєктів, під час створення застосунку вкажіть Папку проєкту (наприклад, apps/web). Інша папка того самого репозиторію може працювати як окремий вебсервіс — див. Сервіси проєкту.