For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/ship-in-5-minutes.md (or send Accept: text/markdown).
Запуск за 5 минут
Запустите веб-демонстрацию на своем компьютере с точными командами Windows и macOS, без платных учетных данных поставщика и с четким путем к реальным учетным записям, поддерживаемым базой данных.
1. Подготовьте компьютер и откройте проект.
Сначала пройдите руководство «Прежде чем начать»: примите приглашение GitHub, установите Node.js 22 или новее, Git, редактор и Corepack, затем клонируйте свой веб-репозиторий или монорепозиторий All Platforms. Откройте папку supastack в редакторе и выберите «Терминал» → «Новый терминал». В списке файлов верхнего уровня редактора должен быть виден package.json. Все приведённые ниже команды выполняются из корня этого репозитория.
Это запускает локальную демонстрацию без аккаунтов у AI-, биллинг- или почтовых провайдеров и без Docker. Заложите дополнительное время на первую загрузку зависимостей. В следующих шагах следуйте только блоку Windows или только блоку macOS/Linux — не выполняйте оба.
2. Создайте файлы конфигурации — macOS/Linux.
В своем терминале выполните каждую строку ниже. Первая копия создает .env для последующих команд миграции. Второй создает apps/web/.env.local, который фактически читает веб-сервер. Оба содержат локальные настройки примера. Если какой-либо целевой файл уже существует, сохраните его и пропустите команду копирования; не перезаписывайте сохраненные настройки. Вместо этого пользователи Windows используют следующий раздел.
corepack pnpm install загружает библиотеки, необходимые приложению. Если Corepack попросит загрузить pnpm, ответьте «да». Подождите, пока он завершится и не вернется приглашение терминала. Последнее сообщение Done без ошибки означает, что вы можете продолжить.
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install2. Создайте файлы конфигурации — Windows PowerShell.
Используйте эти команды в PowerShell из папки, содержащей package.json. Если .env или apps/web/.env.local уже существует, пропустите строку копирования и сохраните свои настройки. Прежде чем запускать сервер, дождитесь завершения установки. Если выполнение сценария заблокировано, используйте corepack.cmd вместо corepack, как описано в разделе «Перед началом работы».
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install3. Запустите веб-сервер — оставьте этот терминал открытым.
Запустите команду ниже из корня репозитория. Он запускает только веб-приложение, поэтому работает как в веб-репозитории, так и в монорепозитории для всех платформ. Подождите, пока терминал отобразит Local: http://localhost:3000 и Ready. Компиляция первой страницы может занять немного больше времени. Терминал должен продолжать работать; это ожидаемо.
В монорепозитории «Все платформы» corepack pnpm dev одновременно запускает доступные рабочие области разработки. Если apps/docs присутствует, это отдельное приложение документации использует http://localhost:3001.. Общедоступные руководства, которые вы читаете, являются частью веб-приложения по адресу http://localhost:3000/docs.. Для работы с этим руководством вам не нужен порт 3001.
corepack pnpm --filter @supastack/web dev4. Откройте приложение и выполните одно локальное задание.
В адресной строке браузера откройте http://localhost:3000, чтобы увидеть домашнюю страницу. Затем откройте http://localhost:3000/dashboard.. Сохраните предварительно заполненное имя и адрес электронной почты или введите свои собственные тестовые значения и нажмите Start local reference flow. Это создает демонстрационное рабочее пространство в памяти; он не создает постоянную учетную запись и не отправляет настоящее электронное письмо.
В демонстрации откройте AI task на боковой панели, введите короткий запрос, например «Суммируйте локальные критерии приемки», и нажмите Queue local task. Когда его статус окажется в очереди, нажмите Run local task, затем View result. Вы должны увидеть завершенный вывод и состояние Email queued. Реакция ИИ намеренно фальшивая и повторяемая; электронное письмо в очереди является локальным. Перезапуск сервера удаляет эти демонстрационные данные.
Чтобы использовать /auth для реальной регистрации, сначала запустите Postgres и примените миграции, используя руководство по базе данных и миграции. После этого регистрацию или сообщения OTP от EMAIL_PROVIDER=local можно проверить на http://localhost:3000/mail-preview;, они не доходят до внешнего почтового ящика. Для входа в систему с мобильных устройств также используется проверка подлинности на основе базы данных, а не демонстрационный сеанс.
5. Остановка, перезапуск и устранение распространенных проблем при первом запуске.
Успех означает, что домашняя страница загружается, открывается локальная рабочая область и задача в очереди завершается. Когда вы закончите, щелкните терминал сервера и нажмите Ctrl + C. Чтобы возобновить работу позже, снова откройте терминал в корне репозитория и повторите команду сервера, начиная с шага 3; вы не переустанавливаете зависимости каждый раз.
Если localhost:3000 не открывается, убедитесь, что серверный терминал все еще работает и показывает Ready. Если порт 3000 используется, остановите другой сервер разработки, нажав Ctrl + C, и повторите попытку. Если вы видите ошибку базы данных после открытия /auth, вернитесь в /dashboard для демонстрации или выполните руководство по базе данных. Если локальная демонстрация отсутствует, проверьте APP_ENV=local, AI_PROVIDER=fake, BILLING_PROVIDER=local, EMAIL_PROVIDER=local и JOB_PROVIDER=local в apps/web/.env.local, а затем перезапустите.
Чтобы настроить имя и маркетинговый текст, откройте apps/web/src/marketing/site-config.ts в редакторе. Следуйте инструкциям по брендингу, чтобы узнать точные поля и этапы проверки. Для настройки внешнего вида реальной учетной записи сначала завершите настройку базы данных, а затем откройте /settings/appearance. Команды автоматического принятия занимают больше времени, чем это пошаговое руководство при первом запуске; найдите их в разделе «Команды рабочей области».