Runbooks

Local Setup

Настройка локального окружения.

Настройка локального окружения.

Применимо для: feature, change, bug, improvement — любая задача, требующая локальной разработки.

Prerequisites

  • Node.js >= 20
  • pnpm >= 9
  • Git

Шаги

1. Клонировать репозиторий

# Приложение
git clone <app-repository-url>
cd app-admin  # или другое приложение

# Модули (для разработки модулей)
git clone <modules-repository-url>
cd platform-core

2. Установить зависимости

pnpm install

3. Настроить переменные окружения

cp .env.example .env

Отредактировать .env:

NUXT_PUBLIC_API_BASE=http://localhost:3001/api

4. Запустить dev сервер

pnpm dev

5. Проверить работу

Открыть в браузере: http://localhost:3000

Troubleshooting

Cannot find module

Симптомы: Cannot find module '@scope/helpers'

Решение:

pnpm install

Port already in use

Симптомы: Error: listen EADDRINUSE :::3000

Решение:

lsof -i :3000
kill -9 <PID>

Связанные документы