Lutra/docs/localization-parity.md
danny 7c0fb312f6 M1.11: English message catalog for every UI string
ui/src/i18n: en.json (20 flat dotted keys) and t(key, params?) with
{name} interpolation; a missing key warns in dev and returns the key.
All template text, title/aria-label attributes, notices and frontend
error texts go through t. ESLint vue/no-bare-strings-in-template is an
error. Catalog tests: interpolation, missing key, every t() key exists,
no unused keys. Engine messages stay English (G14). Docs updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 06:39:42 +02:00

1.7 KiB

Localization checklist

Status: English catalog covers 100% of UI strings (M1.11); German not started · Last updated: 2026-10-15

Language Code Status Translated
English en source catalog (ui/src/i18n/en.json) 100% of UI strings (20 keys, measured by the catalog test)
German de planned (G14) 0%

All interface strings go through the message catalog: t(key, params?) from ui/src/i18n, flat dotted keys grouped by area (app.*, project.*, editor.*, common.*), {name} placeholders. Lint (vue/no-bare-strings-in-template, error) rejects bare text in templates; a Vitest scan checks that every key passed to t exists in en.json and that the catalog has no unused keys.

Checklist

  • English message catalog and t helper (M1.11)
  • Lint rule against bare template strings (M1.11)
  • Every UI string in ui/src from the catalog: templates, title and aria-label attributes, notices, frontend error texts (M1.11)
  • Engine messages: EngineError.message and other texts the engine sends are English only; they need message keys and params (G14)
  • Setting labels and descriptions from settings.list (labelKey, descriptionKey) in the catalog (M1.9b)
  • Language switch through ui.language; the catalog becomes reactive (G14)
  • Plural forms and number/date formatting per locale (G14)
  • German catalog (G14)
  • Native menus and dialogs of the desktop shell (folder picker title, app menu) (G14)

Revision history

Date Change Summary
2026-10-15 minor M1.11: English catalog, lint rule, checklist; engine-message gap
2026-10-13 major Baseline