30 languages with full dashboard UI translation, translated documentation, and RTL support for Arabic and Hebrew.

Languages: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇩🇪 Deutsch | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇸🇦 العربية | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇹🇷 Türkçe | 🇺🇦 Українська | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino | 🇨🇿 Čeština

UI strings: (English source, ~2800 keys)
• Locale files: (30 translations)
• Framework: with cookie-based locale resolution
• Config: — defines all 30 locales, language names, flags

cookie set
1. resolves locale: cookie → header → fallback
3. and

:

// Add to LOCALES array
"xx",
// Add to LANGUAGES array
{ code: "xx", label: "XX", name: "Language Name", flag: "🏳️" },

— add entry to :

{
  code: "xx",
  googleTl: "xx",
  label: "XX",
  flag: "🏳️",
  languageName: "Language Name",
  readmeName: "Language Name",
  docsName: "Language Name",
},

node scripts/i18n/generate-multilang.mjs messages

auto-translated from via Google Translate.

• , , etc.)

python3 scripts/validate_translation.py quick -l xx
python3 scripts/validate_translation.py diff common -l xx

node scripts/i18n/generate-multilang.mjs docs

Primary auto-translation engine — uses Google Translate free API to generate translations for UI strings, READMEs, and documentation.

node scripts/i18n/generate-multilang.mjs [messages|readme|docs|all]

	from
	into all locales as in project root
	into

Features:

Text protection: Masks code blocks (), inline code (), markdown links/images (), HTML tags, tables, and ICU placeholders (, , , etc.) before translation, then restores them
• Chunked batching: Joins multiple strings with delimiters to minimize API calls (max 1800 chars per request)
• In-memory cache: Avoids redundant API calls for repeated strings within a session
• Retry logic: Exponential backoff (up to 5 attempts with 300ms × attempt delay) for 429/5xx errors
• Timeout: 20 seconds per request
• Skip existing: If target file already exists, it is NOT overwritten

Important behaviors:

is regenerated each run — it's an auto-generated index of all docs
• files are only created if they don't exist (skips locales in )
• ) are automatically inserted/updated in all translated docs

Secondary translator — uses any OpenAI-compatible LLM API (including OmniRoute itself) to translate existing markdown files. Best for polishing or re-translating docs with better quality than Google Translate.

python3 scripts/i18n_autotranslate.py \
  --api-url http://localhost:20128/v1 \
  --api-key sk-your-key \
  --model gpt-4o

Features:

markdown files for English paragraphs

Translation validator — compares any locale JSON against and reports issues.

# Quick check (counts only)
python3 scripts/validate_translation.py quick -l cs
# Output:
# Missing: 0
# Untranslated: 0
# Ignored (UNTRANSLATABLE_KEYS): 236

# Detailed diff by category
python3 scripts/validate_translation.py diff common -l cs
python3 scripts/validate_translation.py diff settings -l cs

# Export to CSV
python3 scripts/validate_translation.py csv -l cs > report.csv

# Export to Markdown
python3 scripts/validate_translation.py md -l cs > report.md

# Full report (default)
python3 scripts/validate_translation.py -l cs

Detects:

Missing keys — keys in but not in locale file
• Extra keys — keys in locale file but not in
• Untranslated keys — keys where locale value equals English source (excluding allowlist)
• Placeholder mismatches — ICU placeholders that don't match between source and translation

Exit codes:

Environment: Set or use flag.

Code-to-JSON key checker — scans and for calls and verifies all referenced keys exist in .

# Basic check
python3 scripts/check_translations.py

# Verbose output
python3 scripts/check_translations.py --verbose

# Auto-fix (adds missing keys to en.json)
python3 scripts/check_translations.py --fix

Static analysis QA — scans Next.js page files for i18n risk metrics and generates a Markdown report.

node scripts/i18n/generate-qa-checklist.mjs

Checks:

• )
• , , , , )

Output:

Visual QA via Playwright — takes screenshots of all dashboard routes in multiple locales and viewports, then evaluates page health.

# Default: es, fr, de, ja, ar on localhost:20128
node scripts/i18n/run-visual-qa.mjs

# Custom base URL and locales
QA_BASE_URL=http://staging.example.com QA_LOCALES=de,fr node scripts/i18n/run-visual-qa.mjs

# Custom routes
QA_ROUTES=/dashboard/settings,/dashboard/providers node scripts/i18n/run-visual-qa.mjs

Detects:

Output: + JSON report

File:

to avoid false-positive "untranslated" warnings.

{
  "description": "Keys that should remain untranslated...",
  "keys": [
    "common.model",
    "common.oauth",
    "health.cpu",
    ...
  ]
}

What belongs here:

,
• , ,
• ,
• ,
• , ,
• ,

To add a key: Edit the array in and re-run validation.

)

job — dynamically discovers all locale files (excluding )
1. job — runs for each locale in parallel
2. job — aggregates results into a dashboard summary

# i18n-matrix: discovers languages
LANGS=$(ls src/i18n/messages/*.json | xargs -n1 basename | sed 's/.json$//' | grep -v '^en$')

# i18n: validates each language
python3 scripts/validate_translation.py quick -l '${{ matrix.lang }}'

Dashboard output:

Always edit first — it's the source of truth
1. Run to propagate new keys to all locales
2. Review auto-translations — Google Translate is a starting point, not final
3. Validate before committing —
4. Update if a key should remain in English

, , , ) must be preserved exactly
• ) must maintain structure

// Use namespaced keys
const t = useTranslations("settings");
t("cacheSettings"); // maps to settings.cacheSettings in JSON

// Run check_translations.py to verify keys exist
python3 scripts/check_translations.py --verbose

) and Hebrew () are RTL locales
• / CSS — use / logical properties

→ Fix

(deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 . This created an orphaned duplicate of . Fixed by changing to in and removing the orphaned file.

Is Auto-Generated

file is completely regenerated by . Any manual edits will be lost. Use (this file) for hand-written documentation that should persist.

allowlist was moved from an inline Python set in to an external JSON file for easier maintenance. The validator loads it at runtime.

Hindi Code Fix

(deprecated Google Translate code) for Hindi instead of the correct ISO 639-1 . This was introduced in upstream commit by . Fixed by changing to in the array and removing the orphaned file.

Ignored Count Output

check now displays the count of ignored keys from :