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

# Документация продукта

Выделенное docs-приложение, поставляемое с китом.

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

Откройте загруженный проект 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
```


## Настройка и конфигурация

apps/docs — это обращённая к покупателю поверхность документации для продукта, который вы строите, отдельная от документации самого кита. Она рендерит собственные гайды вашего продукта с навигацией, якорями страниц и поиском и работает как собственное приложение воркспейса на порту 3001 в разработке.

Держите её контент типизированным и версионируемым в репозитории рядом с функциями, которые он описывает; документ, расходящийся с кодом, хуже отсутствующей страницы.

```
apps/docs/        Product documentation app
  content/        Guide sources and nav order
  app/            Routes, layout, search
```


## Рабочий процесс внедрения

Моделируйте документацию продукта по структуре кита: стартовый путь, страница на каждую область функций и справочные страницы по конфигурации и API. Переиспользуйте формат гайдов кита, чтобы инструменты (поисковый индекс, копирование как Markdown) продолжали работать.

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


## Проверка и устранение неполадок

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


## Вперёд

[Фичефлаги и анонсы](https://supastack.dev/ru/docs/web/feature-flags.md)