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/tanstack/tech-stack.md (or send Accept: text/markdown).
Технологический стек
Технологии, лежащие в основе кита, и роль каждой из них.
Прежде чем начать
Откройте загруженный проект supastack в Visual Studio Code, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Корень репозитория — это папка, содержащая package.json, приложения и пакеты. Запустите команду ниже и оставьте терминал открытым. Если команда не распознается, завершите руководство по установке инструмента, прежде чем продолжить.
Сначала прочтите руководство по платформе. Сервер — это процесс приложения, который отвечает на запросы браузера или телефона. Веб читает apps/web-tanstack/.env.local, Expo читает apps/mobile/.env.local, а команды миграции базы данных читают корневой .env. Демонстрация без базы данных / панели мониторинга отделена от реальных учетных записей / аутентификации, для которых необходимо перенести Postgres. Для оформления заказа только на телефоне или компьютере требуется отдельно работающий веб-сервер.
- Установите инструменты и получите код
- Изучение команд, файлов и конфигурации
- Пройдите руководство по первому запуску в Интернете
corepack pnpm --filter @supastack/web-tanstack devСтек приложения
Веб-приложение — это приложение TanStack Start, собранное из общих пакетов TypeScript; те же пакеты используются мобильным приложением Expo. Интерфейс продукта использует CSS-модули поверх дизайн-токенов, поэтому отлаживать CSS-in-JS в рантайме не нужно, а объектное хранилище совместимо с S3. Ниже перечислены выбранные инструменты по умолчанию.
TanStack Start + React
Веб-приложение работает на TanStack Start с файловыми маршрутами TanStack 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
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:tanstack # browser flows