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

# SEO и шаринг

Метаданные, sitemap, robots и социальные изображения.

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

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


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

Метаданные уровня маршрута приходят из metadata API Next.js — страницы экспортируют объект metadata или generateMetadata, разрешая заголовки и описания из словарей локали, чтобы результаты поиска оставались локализованными.

sitemap.ts и robots.ts генерируют сканируемую поверхность; изображение Open Graph и иконки несут социальный превью. Держите приватные маршруты — settings, billing, admin, API — вне sitemap и под disallow в robots.

```
app/sitemap.ts    public routes only
app/robots.ts     disallow private surfaces

// per page
export const metadata = { title, description };
```


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

Давайте каждой публичной странице уникальный заголовок и описание; никогда не индексируйте результаты поиска, отфильтрованные виды или аутентифицированные поверхности. Канонические URL остаются без префикса — слой локали уже редиректит локаль по умолчанию на канонический путь.

Добавляя публичный маршрут, добавляйте его в sitemap в том же изменении. Держите OG-изображения на брендовых токенах вместо запечённых скриншотов, чтобы рестайлы оставались консистентными.


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

Запросите /robots.txt и /sitemap.xml на preview-деплое, проверьте, что sitemap парсится, и проверьте шаринг одной страницы — заголовок, описание, изображение. Убедитесь в наличии noindex-заголовка или meta на страницах результатов поиска.


## Вперёд

[Тема продукта](https://supastack.dev/ru/docs/web/theming.md)