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/web.md (or send Accept: text/markdown).
Введение
Что такое supastack, что вы получаете и путь к работающему приложению.
Начните здесь: что вы получили
Комплект представляет собой стартовое приложение, которое можно настроить. Web — это интерфейс браузера плюс сервер API; Мобильный телефон — это интерфейс телефона; Рабочий стол — это собственное окно, отображающее веб-приложение. API — это адрес сервера, который вызывает клиент для входа в систему или чтения данных. Общие пакеты — это многократно используемые части, используемые этими приложениями.
Начните с локального веб-руководства ниже. Там подробно рассказывается, как загрузить библиотеки, запустить сервер и запустить поддельный AI task. Затем добавьте базу данных сохраненных аккаунтов, выберите только тех провайдеров, которые нужны вашему продукту, настройте свой бренд и подготовьте хостинг. Вы можете прочитать технические пояснения позже; они не являются обязательными условиями для открытия первой демо-версии.
Стройте на общем фундаменте
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-проверка реальных провайдеров, развёртывание и приёмка на физическом устройстве остаются отдельными этапами проверки.
Добро пожаловать в supastack
supastack — модульный кит для AI SaaS-продуктов: веб-приложение Next.js, мобильное приложение Expo и десктопная оболочка Tauri, всё построено на общих TypeScript-пакетах для аутентификации, биллинга, AI, задач, почты, хранилища и наблюдаемости.
После покупки вы получаете приглашение GitHub в репозитории кита — web, mobile и desktop (бандл All Platforms доставляет полный монорепозиторий). Клонируйте поверхность, которую поставляете, и сделайте её своей.
Эта документация — пошаговый путь, а не справочный дамп: сначала запустите приложение локально, затем пройдите страницы настройки провайдеров по порядку. Каждая страница завершается указанием на следующую.
Запустите локальный сервер
Вам нужен Node.js 22 или новее. Репозиторий фиксирует свой пакетный менеджер (packageManager: [email protected]), поэтому запускайте 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 минут.