Перейти к содержимому
supastack
Обзор документации
WebNext.js

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/tech-stack.md (or send Accept: text/markdown).

Технологический стек

Технологии, лежащие в основе кита, и роль каждой из них.

Задать вопрос об этом руководстве
Открыть в

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

Откройте загруженный проект supastack в Visual Studio Code, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Корень репозитория — это папка, содержащая package.json, приложения и пакеты. Запустите команду ниже и оставьте терминал открытым. Если команда не распознается, завершите руководство по установке инструмента, прежде чем продолжить.

Сначала прочтите руководство по платформе. Сервер — это процесс приложения, который отвечает на запросы браузера или телефона. Веб читает apps/web/.env.local, Expo читает apps/mobile/.env.local, а команды миграции базы данных читают корневой .env. Демонстрация без базы данных / панели мониторинга отделена от реальных учетных записей / аутентификации, для которых необходимо перенести Postgres. Для оформления заказа только на телефоне или компьютере требуется отдельно работающий веб-сервер.

corepack pnpm --filter @supastack/web dev

Стек приложения

Веб-приложение — это приложение Next.js, собранное из общих пакетов TypeScript; те же пакеты используются мобильным приложением Expo. Интерфейс продукта использует CSS-модули поверх дизайн-токенов, поэтому отлаживать CSS-in-JS в рантайме не нужно, а объектное хранилище совместимо с S3. Ниже перечислены выбранные инструменты по умолчанию.

Next.js + React

Веб-приложение работает на Next.js 16 с App Router и серверными компонентами React 19.

TypeScript + Turborepo

Строгий режим TypeScript действует во всём workspace pnpm, а Turborepo координирует сборки.

Better Auth

Better Auth — движок идентификации; для команд, стандартизирующихся на Auth.js, доступен и этот движок.

Drizzle + PostgreSQL

Хранение данных идёт через ORM Drizzle на PostgreSQL — схема и хелперы, через которые проходит каждая запись.

Биллинг

Биллинг Stripe — вариант по умолчанию, адаптер Lemon Squeezy включён.

Trigger.dev

Фоновые задачи выполняются на Trigger.dev.

Транзакционная почта

Транзакционные письма отправляются через Resend или AWS SES.

Sentry + PostHog

Наблюдаемость построена на Sentry и PostHog.

Expo

Мобильное приложение Expo использует те же пакеты TypeScript, поэтому изменения контрактов типизируются сразу для обеих поверхностей. Expo собирает сборки для iOS и Android.

Общие модули

Каждая сквозная возможность живёт в пакете с небольшим контрактом: auth, db, billing, ai, jobs, email, storage, observability, config, i18n и api. Приложения их компонуют; продуктовая доменная логика остаётся вне кита.

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

Инструменты проверки

Vitest покрывает юнит- и интеграционное поведение, Playwright — браузерные сценарии, а ESLint и Prettier поддерживают единообразие кода. Детерминированный набор тестов работает без учётных данных провайдеров; приёмка с реальными провайдерами — отдельный необязательный путь.

corepack pnpm test          # deterministic unit + integration
corepack pnpm check         # lint, types, tests, format
corepack pnpm build         # production builds
corepack pnpm test:e2e      # browser flows

Часто задаваемые вопросы

14 вопросов

Что такое supastack?

supastack — модульная основа для создания SaaS-продуктов с AI. Она объединяет общую инфраструктуру, чтобы вы могли сосредоточиться на продуктовых функциях.

Поддерживает ли он web и mobile?

Да. supastack включает приложения Next.js и Expo как отправные точки для web- и мобильных интерфейсов.

Какая аутентификация включена?

Better Auth покрывает e-mail/пароль, OTP и социальный вход. Личные воркспейсы провижинируются вместе с аккаунтом, чтобы продуктовые записи были ограничены с первого дня.

Как он поддерживает AI?

supastack включает настраиваемый мультипровайдерный AI, учёт использования, бюджеты и зашифрованную поддержку bring-your-own-key.

Как обрабатываются подписки?

Для продуктов на ките Stripe-биллинг, подписки и права доступа образуют основу платного доступа. Секреты провайдеров остаются только на сервере.

Где живёт мой продуктовый код?

Продуктовые функции остаются в отдельном коде, а продукт настраивает и интегрирует модули основы supastack.

Как устроены цены supastack?

Кит — разовая покупка с пожизненными обновлениями: один фреймворк за $249 (временная стартовая цена — скидка $100 от стандартной цены $349) или все фреймворки (Next.js, iOS, Android) за $499 (временная стартовая цена — скидка $100 от стандартной цены $599), плюс $75 за каждое дополнительное место разработчика. Без подписки на кит. Оплата на этом сайте доставляет лицензионный ключ по e-mail, доступ к репозиторию — через приглашение GitHub.

Как воркспейсы ограничивают мои данные?

Записи пользователей ограничены по workspaceId. Идентичность, права доступа, AI-использование, события биллинга и записи аудита остаются внутри границы личного воркспейса.

Как работают фоновые задачи?

Trigger.dev — явный рантайм задач. Контракт JobRunner обещает только enqueue, status и cancel — семантика workflow остаётся специфичной для Trigger.dev и явной.

Чем почта отличается от рассылок?

Транзакционная почта покрывает продуктовые сценарии вроде уведомлений о завершении. Холодные рассылки и кампании — забота продукта, вне почтового модуля этого кита.

Как работают покупки в мобильном приложении?

Мобильное приложение поддерживает нативные покупки и восстановление через RevenueCat, а сервер проверяет доступ. Настройте аккаунты магазинов и завершите тестирование на устройствах перед публикацией. Веб-оплата остается отдельной.

Где хранятся ключи AI-провайдеров?

Bring-your-own-key креденшелы зашифрованы и остаются только на сервере. Ключи удаляются из логов; использование и бюджеты видны на уровне воркспейса.

Какие способы оплаты принимает оформление заказа?

Оформление заказа на Stripe принимает карты, а после включения кошельков в аккаунте Stripe может также предлагать Alipay и WeChat Pay — удобно для покупателей из Китая. Авторизации кошельков подтверждаются асинхронно, поэтому страница лицензии обновляется, как только платёж завершается.

Могу ли я получить возврат средств?

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

RU
Тема