Lingue e testi

Installazione e configurazione

Prima di qualsiasi passaggio, leggere Prima di iniziare e Nozioni di base sui terminali. Queste istruzioni presuppongono che tu abbia aperto l'intero supastack monorepo in VS Code; la sua radice package.json contrassegna la radice del repository. Nei comandi pnpm, un pacchetto dell'area di lavoro è un'app o una cartella di codice condiviso; nel prodotto, uno spazio di lavoro è il contenitore dei dati di un team e il limite di sicurezza. corepack pnpm --filter ... seleziona un pacchetto dal monorepo mentre i comandi vengono eseguiti dalla sua radice. Se hai aperto solo una cartella mobile o desktop sincronizzata, non contiene il backend Web, la configurazione di Docker o gli script root: esegui il backend da questo monorepo o da un server ospitato raggiungibile e utilizza gli script della cartella della piattaforma. Una variabile di ambiente è un'impostazione denominata memorizzata in un file .env locale o nel dashboard dell'hosting; riavvia l'app pertinente dopo averla modificata e mantieni i segreti del server fuori dai valori NEXT_PUBLIC_ e EXPO_PUBLIC_.

1. Apri packages/i18n/src/index.ts in VS Code per vedere i nomi delle lingue supportate e gli helper locali; individuare i file del dizionario corrispondenti prima di modificare la copia del prodotto.

2. Aggiungi la stessa nuova chiave e traduzione ai dizionari inglese, tedesco, spagnolo e francese.

3. Dalla root del repository eseguire corepack pnpm test -- packages/i18n/src/index.test.ts e avviare Web con corepack pnpm --filter @supastack/web dev. Previsto: il cambio di lingua modifica il testo visibile preservando il percorso della pagina corrente.

Le impostazioni locali risiedono in @supastack/i18n con SUPPORTED_LOCALES, LOCALE_COOKIE, risolvereLocale, getDictionary e localePath. Il proxy imposta x-supastack-locale e gestisce i reindirizzamenti canonici in inglese; LanguageSwitcher aggiorna il cookie e preserva i sottopercorsi attivi. I percorsi principali delle app (/dashboard, /settings, /billing, /chat) funzionano direttamente con i prefissi /[locale] insieme alla home marketing soft /{locale}.

I dizionari coprono la navigazione di marketing, le etichette delle sezioni delle impostazioni, il chrome delle impostazioni dell'organizzazione, la posta transazionale (invito/OTP/magic-link/AI/fatturazione), le etichette delle preferenze di notifica e la copia degli eventi di notifica in-app.

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

Comandi da copiare

Segui i commenti per vedere in quale cartella viene eseguito un comando. Se due terminali sono etichettati, apri due finestre di terminale e mantieni il primo comando in esecuzione mentre usi il secondo.

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

Flusso di implementazione

Passa le impostazioni locali alle pagine delle impostazioni/organizzazione rese dal server e alle opzioni di consegna della posta notificationCopyForEvent/auth quando disponibili. Mantieni l'inglese come DEFAULT_LOCALE ed evita di inventare affermazioni di marketing al di fuori delle chiavi del dizionario.

La mail transazionale resta separata dall'outreach. Espandi i dizionari prima di annidare ogni route marketing sotto [locale].

Verifica e risoluzione dei problemi

Se per una frase appare l'inglese, controlla che la chiave esista in tutti e quattro i dizionari e che la pagina richieda la stessa chiave. Se cambiando lingua si ritorna alla home page, mantieni il percorso corrente durante la creazione del collegamento locale. Conserva la copia dell'e-mail nel percorso dell'e-mail transazionale; non riutilizzarlo come sensibilizzazione collettiva.

Esegui packages/i18n Vitest, test proxy e test dei percorsi delle app locali. Controlla a campione LanguageSwitcher su / e le intestazioni localizzate Impostazioni/org/dashboard/fatturazione/chat quando il prefisso locale è de/es/fr.