> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Запуск за 5 минут Запустите веб-демонстрацию на своем компьютере с точными командами Windows и macOS, без платных учетных данных поставщика и с четким путем к реальным учетным записям, поддерживаемым базой данных. ## 1. Подготовьте компьютер и откройте проект. Сначала пройдите руководство «Прежде чем начать»: примите приглашение GitHub, установите Node.js 22 или новее, Git, редактор и Corepack, затем клонируйте свой веб-репозиторий или монорепозиторий All Platforms. Откройте папку supastack в редакторе и выберите «Терминал» → «Новый терминал». В списке файлов верхнего уровня редактора должен быть виден package.json. Все приведённые ниже команды выполняются из корня этого репозитория. Это запускает локальную демонстрацию без аккаунтов у AI-, биллинг- или почтовых провайдеров и без Docker. Заложите дополнительное время на первую загрузку зависимостей. В следующих шагах следуйте только блоку Windows или только блоку macOS/Linux — не выполняйте оба. [Установите инструменты и получите код](https://supastack.dev/ru/docs/web/before-you-start.md) [Узнайте, как запустить команду и отредактировать файл](https://supastack.dev/ru/docs/web/terminal-basics.md) [Или позвольте агенту выполнить настройку за вас](https://supastack.dev/ru/docs/web/agent-setup.md) ## 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 install ``` ## 2. Создайте файлы конфигурации — 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 install ``` ## 3. Запустите веб-сервер — оставьте этот терминал открытым. Запустите команду ниже из корня репозитория. Он запускает только веб-приложение, поэтому работает как в веб-репозитории, так и в монорепозитории для всех платформ. Подождите, пока терминал отобразит Local: http://localhost:3000 и Ready. Компиляция первой страницы может занять немного больше времени. Терминал должен продолжать работать; это ожидаемо. В монорепозитории «Все платформы» corepack pnpm dev одновременно запускает доступные рабочие области разработки. Если apps/docs присутствует, это отдельное приложение документации использует http://localhost:3001.. Общедоступные руководства, которые вы читаете, являются частью веб-приложения по адресу http://localhost:3000/docs.. Для работы с этим руководством вам не нужен порт 3001. ``` corepack pnpm --filter @supastack/web dev ``` ## 4. Откройте приложение и выполните одно локальное задание. В адресной строке браузера откройте 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;, они не доходят до внешнего почтового ящика. Для входа в систему с мобильных устройств также используется проверка подлинности на основе базы данных, а не демонстрационный сеанс. [Добавить Postgres и постоянные учетные записи](https://supastack.dev/ru/docs/web/database.md) ## 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. Команды автоматического принятия занимают больше времени, чем это пошаговое руководство при первом запуске; найдите их в разделе «Команды рабочей области». [Исправить ошибку при первом запуске](https://supastack.dev/ru/docs/web/troubleshooting.md) [Измените название и копию продукта](https://supastack.dev/ru/docs/web/marketing-site.md) Чтобы продолжить настройку, прочитайте [Настройка базы данных](https://supastack.dev/ru/docs/web/setup-database.md). ## Вперёд [Технологический стек](https://supastack.dev/ru/docs/web/tech-stack.md)