> ## 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

# Команды, файлы и конфигурация

Узнайте, куда вставлять команды, как открыть правильную папку проекта, редактировать файлы .env, останавливать сервер и сообщать об ошибке установки, не раскрывая секретов.

## Команда поступает в терминал

Терминал — это окно, в котором вы вводите инструкции для своего компьютера. В Visual Studio Code сначала откройте папку supastack, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Новый терминал запускается в этой папке. В Windows выберите PowerShell, используя меню рядом с кнопкой + на терминале. Используйте блоки macOS/Linux в терминале macOS или Linux.

Вставляйте только содержимое командного блока, по одной команде за раз, и нажмите Enter. Не вставляйте окружающие обратные кавычки Markdown, приглашение, такое как PS C:\..., или пример вывода. Строки, начинающиеся с #, являются пояснениями; они ничего не запускают. Дождитесь завершения каждой команды установки, прежде чем вводить следующую команду. Серверная команда продолжает выполняться и не возвращает новое приглашение, пока вы ее не остановите.


## Проверьте, какую папку использует терминал

Корень репозитория означает папку supastack верхнего уровня, содержащую package.json, pnpm-workspace.yaml, приложения и пакеты. Если в шаге не указано иное, запускайте команды там. Команда ниже печатает текущую папку; в списке файлов должен быть указан package.json. В Windows также работают PowerShell pwd и ls.

Если в списке отображается только содержимое apps/web или apps/mobile, введите cd ../.. и нажмите Enter, чтобы вернуться в корень. Если отображается ваша домашняя папка, введите cd, затем пробел и полный путь к вашему клону, заключенный в кавычки, если он содержит пробелы. Открыть папку проекта в редакторе и создать новый терминал обычно проще.

```
pwd
ls
```


## Конфигурация хранится в файле, а не в терминале

Блок типа AI_PROVIDER=fake представляет собой текст конфигурации. Откройте указанный файл .env в редакторе, найдите строку, начинающуюся с AI_PROVIDER=, замените ее значение и сохраните с помощью Ctrl + S (Command + S в macOS). Каждая настройка занимает одну строку в формате KEY=value. Не добавляйте обратные кавычки Markdown. Избегайте дублирования копий одного и того же ключа в одном файле.

Используйте корневой .env для команд миграции базы данных, apps/web/.env.local для веб-сервера Next.js и apps/mobile/.env.local для Expo. Next и Expo запускаются внутри собственных папок приложений и не загружают автоматически корневой .env. Если подключение к базе данных изменится, обновите DATABASE_URL как в корневом файле .env, так и в apps/web/.env.local, чтобы при миграции и на сервере использовалась одна и та же база данных. Сохраните файл примера без изменений для дальнейшего использования.

Файлы, имена которых начинаются с точки, могут быть скрыты в вашем файловом менеджере; Проводник редактора показывает их. Убедитесь, что имя файла именно .env.local, а не .env.local.txt. Эти локальные файлы могут содержать пароли и исключены из Git; не загружайте их и не вставляйте их содержимое в сообщения поддержки.

[Найдите значение каждой настройки](https://supastack.dev/ru/docs/web/project-structure.md)


## Поддерживайте работу сервера; используйте другой терминал для команд

Сервер разработки обслуживает ваше приложение, пока вы работаете. Оставьте его терминал открытым, когда в руководстве написано «Открыть localhost:3000». localhost означает этот компьютер; :3000 — это порт, аналогичный номеру двери, используемый приложением. Поместите URL в адресную строку браузера, а не в терминал.

Чтобы запустить другую команду, пока сервер активен, выберите «Терминал» → «Новый терминал» в редакторе. Новый терминал — это отдельное окно в тот же проект. Чтобы остановить сервер, выберите его терминал и нажмите Ctrl + C один раз. В Windows, если вас спросят «Завершить пакетное задание», введите Y и нажмите Enter. Дождитесь обычного запроса, прежде чем запускать его снова.

После редактирования настроек веб-среды остановите и перезапустите веб-сервер с помощью приведенной ниже команды. При сохранении исходного файла страница обычно обновляется автоматически, но при изменении среды требуется перезагрузка. После редактирования настроек Expo остановите Expo, затем запустите corepack pnpm --filter @supastack/mobile start --clear, чтобы перезапустить и очистить кэшированный пакет.

```
corepack pnpm --filter @supastack/web dev
```


## Прочтите неудачу и попросите полезную помощь

Если при установке возвращается красный текст ошибки, остановитесь на этом шаге. Прочитайте первую ошибку, а не продолжайте запускать приложение. Команда не найдена обычно означает отсутствие инструмента; отсутствие package.json обычно означает неправильную папку; ECONNREFUSED обычно означает, что необходимый сервер или база данных не работает; EADDRINUSE означает, что другой процесс уже использует этот порт.

При обращении за помощью укажите свою операционную систему, руководство URL и номер шага, точную введенную команду и первое сообщение об ошибке. Удалите пароли, ключи API, токены и часть пароля из любой базы данных URL. Не отправляйте файлы .env. Скриншот ошибки может помочь, но копируемый текст легче диагностировать.

[Устранение конкретной ошибки установки](https://supastack.dev/ru/docs/web/troubleshooting.md)


## Вперёд

[Позвольте агенту выполнить настройку](https://supastack.dev/ru/docs/web/agent-setup.md)