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

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

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

```
corepack pnpm --filter @supastack/web dev
```


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

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


## Next.js + React

Веб-приложение работает на [Next.js](https://nextjs.org) 16 с App Router и серверными компонентами [React](https://react.dev) 19.

- [Next.js](https://nextjs.org)
- [React](https://react.dev)


## TypeScript + Turborepo

Строгий режим [TypeScript](https://www.typescriptlang.org) действует во всём workspace pnpm, а [Turborepo](https://turborepo.com) координирует сборки.

- [TypeScript](https://www.typescriptlang.org)
- [Turborepo](https://turborepo.com)


## Better Auth

[Better Auth](https://better-auth.com) — движок идентификации; для команд, стандартизирующихся на Auth.js, доступен и этот движок.

- [Better Auth](https://better-auth.com)


## Drizzle + PostgreSQL

Хранение данных идёт через ORM [Drizzle](https://orm.drizzle.team) на [PostgreSQL](https://www.postgresql.org) — схема и хелперы, через которые проходит каждая запись.

- [Drizzle](https://orm.drizzle.team)
- [PostgreSQL](https://www.postgresql.org)


## Биллинг

Биллинг [Stripe](https://stripe.com) — вариант по умолчанию, адаптер [Lemon Squeezy](https://www.lemonsqueezy.com) включён.

- [Stripe](https://stripe.com)
- [Lemon Squeezy](https://www.lemonsqueezy.com)


## Trigger.dev

Фоновые задачи выполняются на [Trigger.dev](https://trigger.dev).

- [Trigger.dev](https://trigger.dev)


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

Транзакционные письма отправляются через [Resend](https://resend.com) или AWS SES.

- [Resend](https://resend.com)


## Sentry + PostHog

Наблюдаемость построена на [Sentry](https://sentry.io) и [PostHog](https://posthog.com).

- [Sentry](https://sentry.io)
- [PostHog](https://posthog.com)


## Expo

Мобильное приложение [Expo](https://expo.dev) использует те же пакеты TypeScript, поэтому изменения контрактов типизируются сразу для обеих поверхностей. Expo собирает сборки для iOS и Android.

- [Expo](https://expo.dev)


## Общие модули

Каждая сквозная возможность живёт в пакете с небольшим контрактом: 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
```


## Вперёд

[Локальная установка](https://supastack.dev/ru/docs/web/local-setup.md)