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/desktop/before-you-start.md (or send Accept: text/markdown).
Прежде чем начать
Установите Node.js, Git, редактор, Rust и нативные инструменты сборки, примите приглашение в репозиторий, скачайте набор и проверьте, готов ли компьютер к первому запуску настольного приложения.
1. Выберите, что вы хотите запустить
Используйте компьютер с Windows, macOS или Linux и подключением к интернету. Приложение Desktop — это нативное окно, устанавливаемое на этом же компьютере — телефон не участвует. Шаги ниже устанавливают инструменты и скачивают проект.
Репозиторий — это папка с файлами, которую вы получили через GitHub. Покупка Desktop даёт репозиторий набора Desktop; набор All Platforms даёт монорепозиторий — папку со всеми тремя приложениями. Примите приглашение в купленный вами репозиторий. Репозиторий Desktop содержит оболочку Tauri — нативное окно вокруг веб-приложения, — но не Web-бэкенд, поэтому окно подключается к отдельно работающему адресу бэкенда.
Подготовьте эти инструменты один раз. Загрузка инструментов и первая нативная компиляция могут занять гораздо больше пяти минут. Пятиминутные руководства начинаются после этих приготовлений; локальный запуск не публикует ваше приложение в Интернете.
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 --version
npm --version3. Установите Git и текстовый редактор.
Откройте страницу загрузки Git ниже, выберите свою операционную систему и следуйте инструкциям установщика. Git загружает ваш личный репозиторий и записывает изменения файлов. В macOS выполнение приведенной ниже команды может предложить установку инструментов командной строки Apple; примите его и повторите команду после ее завершения. В Linux используйте команду установки, показанную для вашего дистрибутива на странице Git.
Установите Visual Studio Code с официальной страницы загрузки. Это текстовый редактор для открытия проекта и сохранения файлов конфигурации. Откройте его, выберите «Файл» → «Открыть папку» («Файл» → «Открыть» в macOS), а затем выберите загружаемую папку supastack. Вам не нужно писать код для проведения первой локальной демонстрации.
Во вновь открытом терминале выполните команду ниже. Результат, начинающийся с версии git, означает, что Git готов. Если команда отсутствует, завершите установку и снова откройте терминал.
git --version4. Примите приглашение 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, apps и packages. В checkout Desktop внутри apps отображается только десктопная оболочка; монорепозиторий All Platforms также показывает веб- и мобильное приложения. Это корень репозитория. Если Git сообщает, что назначение уже существует, используйте другую пустую папку или откройте существующий клон; не удаляйте свою работу. Оставьте этот терминал открытым для следующего шага.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. Проверьте 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; если он сообщает об ошибке разрешения, вместо этого используйте отфильтрованную команду первого запуска.
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. Установите Rust и нативные инструменты сборки
В Windows установите Microsoft C++ Build Tools, используя ссылку на необходимые условия Tauri ниже. В установщике выберите «Разработка рабочего стола с помощью C++», оставьте выбранным Windows SDK и завершите установку. Убедитесь, что установлена среда выполнения Microsoft Edge WebView2. Установите Rust из Rustup.rs с помощью Rustup-init.exe; сохраните набор инструментов MSVC по умолчанию. Снова откройте терминал после установки.
В macOS запустите xcode-select --install в Терминале и заполните диалоговое окно инструментов командной строки, если они не установлены. Установите Rust с помощью команды macOS из Rustup.rs. В Linux перейдите на страницу предварительных требований Tauri для получения пакетов WebKitGTK, компилятора, лотка и системной библиотеки вашего конкретного дистрибутива, а затем установите Rust. Названия пакетов Linux различаются; не запускайте команды другого дистрибутива.
Откройте терминал в корне репозитория и запустите проверку версий ниже. И rustc, и cargo должны печатать версии; cargo — инструмент сборки Rust. Если что-то отсутствует, завершите установку и снова откройте терминал, прежде чем продолжить.
rustc --version
cargo --version8. Продолжить с руководствами Desktop
Вы готовы, когда Node и Git выводят версии, Corepack может выбрать закреплённый pnpm, rustc и cargo выводят версии и терминал находится в папке с package.json. Выберите один из учебных пособий ниже.