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

# Locales en copy

Gebruik het vier-locale-dictionaryscaffold voor app-chrome, settingslabels, mail en notificatie-events.

## Setup en configuratie

Lees vóór elke stap [Voordat u begint](https://supastack.dev/nl/docs/web/before-you-start.md) en [Basisbeginselen van de terminal](https://supastack.dev/nl/docs/web/terminal-basics.md). Deze instructies gaan ervan uit dat je de volledige supastack monorepo in VS Code hebt geopend; zijn root package.json markeert de root van de repository. In pnpm-opdrachten is een werkruimtepakket een app of map met gedeelde code; in het product is een werkruimte de gegevenscontainer en de beveiligingsgrens van een team. corepack pnpm --filter ... selecteert één pakket uit de monorepo terwijl opdrachten vanuit de root worden uitgevoerd. Als u alleen een gesynchroniseerde mobiele map of desktopmap hebt geopend, bevat deze niet de webbackend, Docker-installatie of rootscripts: voer de backend uit vanaf deze monorepo of een bereikbare gehoste server en gebruik de eigen scripts van de platformmap. Een omgevingsvariabele is een benoemde instelling die is opgeslagen in een lokaal .env-bestand of op uw hostingdashboard; start de relevante app opnieuw nadat u deze hebt gewijzigd en houd servergeheimen buiten de NEXT_PUBLIC_- en EXPO_PUBLIC_-waarden.

1. Open packages/i18n/src/index.ts in VS Code om de ondersteunde taalnamen en locale-helpers te bekijken; zoek de overeenkomende woordenboekbestanden voordat u de productkopie wijzigt.

2. Voeg dezelfde nieuwe sleutel en vertaling toe aan Engelse, Duitse, Spaanse en Franse woordenboeken.

3. Voer vanuit de root van de repository corepack pnpm test -- packages/i18n/src/index.test.ts uit en start Web met corepack pnpm --filter @supastack/web dev. Verwacht: de taalwisselaar verandert de zichtbare tekst met behoud van het huidige paginapad.

Landinstellingen leven in @supastack/i18n met SUPPORTED_LOCALES, LOCALE_COOKIE, solveLocale, getDictionary en localePath. Proxy stelt x-supastack-locale in en verwerkt canonieke Engelse omleidingen; LanguageSwitcher werkt de cookie bij en behoudt actieve subpaden. Belangrijke app-routes (/dashboard, /settings, /billing, /chat) werken direct onder de voorvoegsels /[locale] naast de zachte /{locale} marketingstartpagina.

Woordenboeken omvatten marketingnavigatie, labels voor instellingensecties, organisatie-instellingen Chrome, transactionele e-mail (invite/OTP/magic-link/AI/billing), labels voor meldingsvoorkeuren en het kopiëren van in-app-meldingsgebeurtenissen.

```
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);
```


## Commando's om te kopiëren

Volg de opmerkingen om te zien in welke map een opdracht wordt uitgevoerd. Als twee terminals zijn gelabeld, opent u twee terminalvensters en laat u de eerste opdracht draaien terwijl u de tweede gebruikt.

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


## Implementatieworkflow

Geef de landinstelling door aan door de server weergegeven instellingen/orgpagina's en aan de opties voor notificatieCopyForEvent/auth-e-mailbezorging, indien beschikbaar. Houd Engels aan als DEFAULT_LOCALE en vermijd het bedenken van marketingclaims buiten de woordenboeksleutels.

Transactionele mail blijft gescheiden van outreach. Breid dictionaries uit voordat je elke marketingroute onder [locale] nest.


## Verificatie en probleemoplossing

Als voor één zin Engels verschijnt, controleer dan of de sleutel in alle vier de woordenboeken voorkomt en of de pagina om dezelfde sleutel vraagt. Als het wisselen van taal terugkeert naar de startpagina, behoud dan het huidige pad bij het maken van de landinstellingslink. Bewaar e-mailkopieën op het transactionele e-mailpad; gebruik het niet als bulk-outreach.

Voer packages/i18n Vitest-, proxy-tests en locale-app-routes-tests uit. Controleer LanguageSwitcher aan / en gelokaliseerde instellingen/org/dashboard/billing/chat-koppen wanneer het landinstellingsvoorvoegsel de/es/fr is.


## Volgende

[Blogartikelen schrijven](https://supastack.dev/nl/docs/web/blog-content.md)