Node.js

Руководство по настройке Node.js проектов с использованием Razd.

Использование

Для работы с Node.js проектами Razd автоматически устанавливает нужную версию Node.js через mise и настраивает окружение для разработки.

Быстрый старт

Клонировать и настроить готовый пример:

razd up https://github.com/razd-cli/razd-nodejs-example

Или настроить существующий проект:

cd your-nodejs-project
razd up

Что происходит при `razd up`

Устанавливает указанную версию Node.js через mise
Устанавливает Task (если указан в конфигурации)
Выполняет задачи настройки (установка зависимостей)
Проект готов к работе!

Конфигурация

Razdfile.yml

Минимальная конфигурация для Node.js проекта:

version: "1"

dependencies:
  using: "mise"
  ensure:
    - "node@22"       # Версия Node.js
    - "pnpm@latest"   # Пакетный менеджер

tasks:
  default:
    deps: [install]
    cmds:
      - pnpm dev

  install:
    desc: "Установка зависимостей"
    cmds:
      - pnpm install

  dev:
    desc: "Запуск dev сервера"
    cmds:
      - pnpm dev

  build:
    desc: "Сборка проекта"
    cmds:
      - pnpm build

mise.toml

Альтернативная конфигурация через mise:

[tools]
node = "22"
task = "latest"

[env]
NODE_ENV = "development"

Taskfile.yml

Пример Taskfile для Node.js проекта:

version: '3'

tasks:
  install:
    desc: Установка зависимостей
    cmds:
      - npm install

  dev:
    desc: Запуск development сервера
    cmds:
      - npm run dev

  build:
    desc: Сборка проекта для production
    cmds:
      - npm run build

  test:
    desc: Запуск тестов
    cmds:
      - npm test

  lint:
    desc: Проверка кода
    cmds:
      - npm run lint

Управление версиями Node.js

Использование конкретных версий

dependencies:
  using: "mise"
  ensure:
    - "node@22.0.0"   # Точная версия
    # - "node@22"     # Последняя 22.x.x
    # - "node@lts"    # Последняя LTS версия (если поддерживается mise)
    # - "node@latest" # Самая новая версия

Работа с пакетными менеджерами

npm (по умолчанию)

tasks:
  install:
    cmds:
      - npm install

pnpm

version: "1"

dependencies:
  using: "mise"
  ensure:
    - "node@22"
    - "pnpm@latest"

tasks:
  install:
    cmds:
      - pnpm install

yarn

version: "1"

dependencies:
  using: "mise"
  ensure:
    - "node@22"
    - "yarn@latest"

tasks:
  install:
    cmds:
      - yarn install

bun

version: "1"

dependencies:
  using: "mise"
  ensure:
    - "bun@latest"

tasks:
  install:
    cmds:
      - bun install

Общие задачи

Установка зависимостей

razd run install

Запуск dev сервера

razd run dev

Сборка проекта

razd run build

Запуск тестов

razd run test

Просмотр всех доступных задач

razd list

Примеры проектов

razd-nodejs-example - простой HTTP сервер с базовой настройкой

Без Razd

Если вы предпочитаете работать без Razd, можно использовать mise напрямую:

# Установка mise
curl https://mise.run | sh

# Установка инструментов
mise install node@22

# Запуск проекта
npm install
npm run dev

Переменные окружения

Настройка переменных окружения в mise.toml:

[tools]
node = "22"