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

# Введение

Что такое supastack, что вы получаете и путь к работающему приложению.

## Начните здесь: что вы получили

Комплект представляет собой стартовое приложение, которое можно настроить. Web — это интерфейс браузера плюс сервер API; Мобильный телефон — это интерфейс телефона; Рабочий стол — это собственное окно, отображающее веб-приложение. API — это адрес сервера, который вызывает клиент для входа в систему или чтения данных. Общие пакеты — это многократно используемые части, используемые этими приложениями.

Начните с локального веб-руководства ниже. Там подробно рассказывается, как загрузить библиотеки, запустить сервер и запустить поддельный AI task. Затем добавьте базу данных сохраненных аккаунтов, выберите только тех провайдеров, которые нужны вашему продукту, настройте свой бренд и подготовьте хостинг. Вы можете прочитать технические пояснения позже; они не являются обязательными условиями для открытия первой демо-версии.

[Установите инструменты и получите код](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/ship-in-5-minutes.md)


## Стройте на общем фундаменте

Supastack — это модульная основа для AI SaaS в Интернете, мобильных устройствах и настольных компьютерах. Next.js содержит веб-интерфейс, а API, Expo обеспечивает собственные ссылочные потоки, а оболочка рабочего стола Tauri загружает то же веб-приложение. Общие пакеты управляют идентификацией, рабочими пространствами, выставлением счетов, искусственным интеллектом, заданиями, электронной почтой, хранилищем и возможностью наблюдения.

Начните с локального справочного потока, чтобы понять, как модули сочетаются друг с другом. Настраивайте производственных поставщиков только после того, как этот поток заработает в вашей среде.


## Найдите свой путь

Приложения составляют общие пакеты. Специфические для продукта функции принадлежат потребляющей кодовой базе продукта, а не многоразовому ядру.

```
apps/
  web/       Next.js interface and API routes
  mobile/    Expo application
packages/
  auth/      Identity and sessions
  db/        Schema and workspace persistence
  billing/   Billing and entitlements
  ai/        Providers, routing, and usage
  jobs/      Background job contract
  email/     Transactional delivery
```


## Выберите отправную точку

Начните с пятиминутной локальной настройки. Затем переходите по ссылке «Продолжить настройку» в нижней части каждого руководства: настройте базу данных, аутентификацию, тарифные планы и провайдеров перед подготовкой к развёртыванию. Используйте полный указатель документации, чтобы найти каждую функцию, провайдера, компонент и справочный материал.

Локальный «золотой путь» проверен в среде разработки проекта. Настройка чистого клона на время, smoke-проверка реальных провайдеров, развёртывание и приёмка на физическом устройстве остаются отдельными этапами проверки.

[Настройка локально за пять минут](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Просмотреть всю документацию](https://supastack.dev/ru/docs/web/project-structure.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/using-the-docs.md)


## Добро пожаловать в supastack

supastack — модульный кит для AI SaaS-продуктов: веб-приложение Next.js, мобильное приложение Expo и десктопная оболочка Tauri, всё построено на общих TypeScript-пакетах для аутентификации, биллинга, AI, задач, почты, хранилища и наблюдаемости.

После покупки вы получаете приглашение GitHub в репозитории кита — web, mobile и desktop (бандл All Platforms доставляет полный монорепозиторий). Клонируйте поверхность, которую поставляете, и сделайте её своей.

Эта документация — пошаговый путь, а не справочный дамп: сначала запустите приложение локально, затем пройдите страницы настройки провайдеров по порядку. Каждая страница завершается указанием на следующую.


## Запустите локальный сервер

Вам нужен Node.js 22 или новее. Репозиторий фиксирует свой пакетный менеджер (packageManager: pnpm@11.19.0), поэтому запускайте pnpm через Corepack — глобальная установка не требуется.

1. Скопируйте файл окружения, чтобы создать локальную конфигурацию.

2. Установите зависимости воркспейса.

3. По желанию запустите локальный контейнер Postgres для реальной персистентности — умолчания работают без него.

4. Запустите dev-сервер и откройте http://localhost:3000.

```
cp .env.example .env
corepack pnpm install
docker compose up -d postgres   # optional local database
corepack pnpm dev

# → http://localhost:3000
```


## Файл .env

Настройки среды позволяют выбрать локальную или размещенную службу, используемую комплектом. Скопируйте .env.example в корневой .env для миграции и в apps/web/.env.local для веб-сервера. Expo использует apps/mobile/.env.local.. Копирование только корневого файла .env не позволяет настроить каждое приложение.

Поддельным/локальным поставщикам по умолчанию не нужны платные учетные данные API. Они позволяют вам завершить демонстрацию в памяти/панели мониторинга; реальный вход в систему /auth по-прежнему требует PostgreSQL и миграции. Для реального провайдера измените только его именованные настройки в файле веб-конфигурации, сохраните, затем остановите и перезапустите сервер. Никогда не раскрывайте секреты через значения NEXT_PUBLIC_ или EXPO_PUBLIC_.


## Выберите свой путь

Здесь впервые? «Запуск за 5 минут» проведёт вас от клона до работающего приложения на одних умолчаниях.

Строите для телефона или десктопа? Вкладки Mobile и Desktop покрывают поверхности Expo и Tauri. Когда приложение запущено, группа «Настройка провайдеров» проводит по каждой интеграции документ за документом.


Чтобы продолжить настройку, прочитайте [Запуск за 5 минут](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md).


## Вперёд

[Запуск за 5 минут](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)