SEO и шаринг

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

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

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

Метаданные уровня маршрута приходят из общих модулей страниц — каждый packages/web-core/src/pages/<route>/page.load.ts экспортирует metadata, которую его файловый маршрут выводит через head() посредством metadataToHead, разрешая заголовки и описания из словарей локали, чтобы результаты поиска оставались локализованными.

Маршруты src/routes/sitemap[.]xml.ts и src/routes/robots[.]txt.ts генерируют сканируемую поверхность; растеризованное OG-изображение (src/framework/og.ts) и иконки несут социальный превью. Держите приватные маршруты — settings, billing, admin, API — вне sitemap и под disallow в robots.

src/routes/sitemap[.]xml.ts   public routes only
src/routes/robots[.]txt.ts    disallow private surfaces

// per page — packages/web-core/src/pages/<route>/page.load.ts,
// surfaced through the route's head() via metadataToHead
export const metadata = { title, description };

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

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

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

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

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