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

# Локали и тексты

Используйте каркас словаря на четыре локали для chrome приложения, меток настроек, почты и событий уведомлений.

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

Перед любым действием прочтите [Перед началом работы](https://supastack.dev/ru/docs/web/before-you-start.md) и [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md). В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. Откройте packages/i18n/src/index.ts в VS Code, чтобы просмотреть поддерживаемые имена языков и помощники локали; найдите соответствующие файлы словарей перед изменением копии продукта.

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

3. Из корня репозитория запустите corepack pnpm test -- packages/i18n/src/index.test.ts и запустите Web с corepack pnpm --filter @supastack/web dev. Ожидается: переключатель языка меняет видимый текст, сохраняя текущий путь к странице.

Локали находятся в @supastack/i18n с SUPPORTED_LOCALES, LOCALE_COOKIE,solveLocale, getDictionary и localePath. Прокси устанавливает x-supastack-locale и обрабатывает канонические перенаправления на английском языке; LanguageSwitcher обновляет файл cookie и сохраняет активные подпути. Ключевые маршруты приложений (/dashboard, /settings, /billing, /chat) работают непосредственно с префиксами /[locale] рядом с программным маркетинговым центром /{locale}.

Словари охватывают маркетинговую навигацию, метки разделов настроек, Chrome настроек организации, транзакционную почту (приглашение/OTP/magic-link/AI/биллинг), метки предпочтений уведомлений и копию событий уведомлений в приложении.

```
import { getDictionary, resolveLocale, LOCALE_COOKIE } from "@supastack/i18n";

const locale = resolveLocale([
  cookieStore.get(LOCALE_COOKIE)?.value,
  headers.get("x-supastack-locale"),
  headers.get("accept-language"),
]);
const copy = getDictionary(locale);
```


## Команды для копирования

Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.

```
corepack pnpm test -- packages/i18n/src/index.test.ts
corepack pnpm --filter @supastack/web dev
```


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

Передайте локаль в отображаемые на сервере страницы настроек/организации и в параметры доставки почты NotificationCopyForEvent/auth, если они доступны. Сохраняйте английский как DEFAULT_LOCALE и избегайте придумывания маркетинговых заявлений за пределами словарных ключей.

Транзакционная почта остаётся отдельной от рассылок. Расширяйте словари до вложения каждого маркетингового маршрута под [locale].


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

Если для одной фразы отображается английский язык, убедитесь, что ключ существует во всех четырех словарях и что страница запрашивает один и тот же ключ. Если при переключении языков возвращается домашняя страница, сохраните текущий путь при создании ссылки на локаль. Храните копию электронного письма на пути к транзакционной электронной почте; не используйте его повторно в качестве массовой аутрич-работы.

Запустите packages/i18n Vitest, прокси-тесты и тесты маршрутов языковых приложений. Выполните выборочную проверку LanguageSwitcher в / и локализованных заголовках Settings/org/dashboard/billing/chat, если префикс локали — de/es/fr.


## Вперёд

[Написание статей блога](https://supastack.dev/ru/docs/web/blog-content.md)