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

# Прежде чем начать

Установите Node.js, Git и редактор, примите приглашение в репозиторий, загрузите комплект и проверьте, готов ли ваш компьютер к первому запуску.

## 1. Выберите, что вы хотите запустить

Используйте компьютер под управлением Windows, macOS или Linux с подключением к Интернету. Браузер запускает веб-приложение; на телефоне установлено мобильное приложение; приложение для ПК открывается в отдельном окне. Ваш телефон самостоятельно не сможет выполнить описанные ниже действия по установке.

Репозиторий — это папка с файлами, полученными вами через GitHub. Покупки через Интернет, мобильные устройства и настольные компьютеры предоставляют соответствующий репозиторий комплектов; пакет «Все платформы» предоставляет монорепо — папку, содержащую все три приложения. Примите приглашение для приобретенного вами репозитория. Для мобильной или настольной кассы по-прежнему требуется доступный веб-сервер: сервер, который обрабатывает учетные записи и данные. Эти клиентские репозитории не включают веб-сервер.

Подготовьте эти инструменты один раз. Загрузка инструментов и первая нативная компиляция могут занять гораздо больше пяти минут. Пятиминутные руководства начинаются после этих приготовлений; локальный запуск не публикует ваше приложение в Интернете.


## 2. Установите Node.js.

Откройте официальную страницу загрузки Node.js ниже. Выберите версию LTS с номером 22 или выше и установщик для вашего компьютера: .msi в Windows или .pkg в macOS. Откройте загруженный установщик, сохраните настройки по умолчанию и завершите установку. Node.js позволяет вашему компьютеру запускать JavaScript приложения; Вместе с ним устанавливается npm.

Закройте и снова откройте терминал после установки. В Windows откройте «Пуск», введите PowerShell и откройте его. В macOS нажмите Command + Пробел, введите Терминал и нажмите Enter. В Linux откройте Терминал из меню приложений. Вставьте команду ниже, затем нажмите Enter. Результат, такой как v22.x.x или v24.x.x, подтверждает, что узел доступен. Если вы видите, что команда не найдена или не распознана, снова откройте терминал или переустановите Node с включенной опцией PATH.

[Официальные установщики Node.js](https://nodejs.org/en/download)

```
node --version
npm --version
```


## 3. Установите Git и текстовый редактор.

Откройте страницу загрузки Git ниже, выберите свою операционную систему и следуйте инструкциям установщика. Git загружает ваш личный репозиторий и записывает изменения файлов. В macOS выполнение приведенной ниже команды может предложить установку инструментов командной строки Apple; примите его и повторите команду после ее завершения. В Linux используйте команду установки, показанную для вашего дистрибутива на странице Git.

Установите Visual Studio Code с официальной страницы загрузки. Это текстовый редактор для открытия проекта и сохранения файлов конфигурации. Откройте его, выберите «Файл» → «Открыть папку» («Файл» → «Открыть» в macOS), а затем выберите загружаемую папку supastack. Вам не нужно писать код для проведения первой локальной демонстрации.

Во вновь открытом терминале выполните команду ниже. Результат, начинающийся с версии git, означает, что Git готов. Если команда отсутствует, завершите установку и снова откройте терминал.

[Официальные установщики Git](https://git-scm.com/downloads/)

[Загрузка Visual Studio Code](https://code.visualstudio.com/download)

```
git --version
```


## 4. Примите приглашение GitHub.

Войдите в GitHub в своем браузере, используя учетную запись, которую вы указали при покупке. Откройте электронное письмо с приглашением GitHub, выберите «Просмотреть приглашение» и примите доступ. Затем откройте приглашенный репозиторий. Вы должны увидеть его файлы и зеленую кнопку «Код». Ошибка 404 обычно означает, что приглашение не было принято или вы вошли в другую учетную запись GitHub.

Выберите «Код» → «Локальный» → HTTPS и скопируйте показанный адрес. Используйте этот точный адрес на следующем шаге. Примеры адресов, содержащих угловые скобки, являются шаблонами: замените их, а не вставляйте скобки. Вам не нужно угадывать название организации или делать частный репозиторий общедоступным.


## 5. Загрузите проект на свой компьютер.

Выберите папку для своих проектов, например «Документы». Откройте эту папку в проводнике или Finder. В Windows щелкните правой кнопкой мыши пустую область и выберите «Открыть в терминале», затем при необходимости выберите PowerShell. В macOS откройте терминал, введите cd, а затем пробел, перетащите папку в терминал и нажмите Enter. Терминал теперь работает в этой папке.

В первой команде ниже замените YOUR_COPIED_HTTPS_ADDRESS на адрес HTTPS, который вы только что скопировали. Запускайте по одной строке за раз. Первая строка создает новую папку с именем supastack; в него входит вторая строка. Если Git попросит вас войти в систему, завершите вход в браузере. Не используйте пароль своей учетной записи GitHub в качестве пароля Git. Если вход в браузер невозможен, следуйте руководству по аутентификации GitHub HTTPS, указанному ниже.

Успех: папка supastack содержит package.json, pnpm-workspace.yaml, приложения и пакеты. Это корень репозитория. Если Git сообщает, что пункт назначения уже существует, используйте другую пустую папку или откройте существующий клон; не удаляйте свою работу. Держите этот терминал открытым для следующего шага.

[GitHub HTTPS справка по аутентификации](https://docs.github.com/en/get-started/git-basics/about-remote-repositories)

```
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack
```


## 6. Проверьте Corepack и закрепленный менеджер пакетов.

Запустите первую команду ниже. Corepack выбирает версию pnpm, записанную в package.json; pnpm загружает библиотеки, которые использует проект. Если Corepack запросит разрешение на загрузку этой версии, введите y и нажмите Enter. Эта проверка выводит pnpm 11.19.0; сохраните его, а не выбирайте другой менеджер пакетов.

Если corepack отсутствует, запустите npm install --global corepack, снова откройте терминал и повторите попытку. Если PowerShell сообщает, что сценарий npm.ps1 или corepack.ps1 не может быть запущен, используйте для этой команды npm.cmd или corepack.cmd, включая corepack.cmd pnpm install. Вам не нужно менять политику выполнения вашего компьютера.

Отфильтрованные команды первого запуска напрямую вызывают Corepack. Если вы используете команду Turbo, например corepack pnpm dev, Turbo также потребуется команда pnpm для PATH. Приведенная ниже установка Windows создает эту команду в папке, доступной для записи пользователем; его изменение PATH действует только для текущего терминала. Запустите этот блок еще раз после открытия нового терминала, если pnpm отсутствует. В macOS/Linux запустите corepack enable; если он сообщает об ошибке разрешения, вместо этого используйте отфильтрованную команду первого запуска.

[Узнайте, как запустить команду и отредактировать файл](https://supastack.dev/ru/docs/web/terminal-basics.md)

```
corepack --version
corepack pnpm --version

# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"
```


## 7. Продолжайте использовать свою платформу

Вы готовы, когда Node и Git выводят версии, Corepack может выбрать закреплённый pnpm, а ваш терминал находится в папке, содержащей package.json. Выберите один из уроков ниже. Docker необязателен для веб-демонстрации; база данных потребуется позже для настоящих аккаунтов. Desktop также требует Rust и нативные инструменты сборки — его руководство объясняет их перед командой запуска.

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

[Запустите веб-приложение](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Запустите мобильное приложение](https://supastack.dev/ru/docs/mobile/ship-in-5-minutes.md)

[Запустите приложение для ПК](https://supastack.dev/ru/docs/desktop/ship-in-5-minutes.md)


## Вперёд

[Команды, файлы и конфигурация](https://supastack.dev/ru/docs/web/terminal-basics.md)