Triage design system v0.13.1-experiment
Home / Foundations / Localisation & i18n

Localisation & i18n

Logical-property mechanics, messages, plurals, formats and bilingual copy rules.
RTL is mechanics; i18n is content. The system already ships the mechanics — logical properties everywhere (TDS013), auto-mirroring chips/drawers/tooltips, and core/i18n.js for locale, messages and formats. This page covers the content side: messages, plurals, dates, numbers and bilingual copy rules.

Direction & locale

live — flips dir and the formats below
Greeting
Hello, Dana
Number
1,234,567.89
Currency
$12.50
Date
6 Oct 2026
Relative
2 days ago
List
rules, flows and tags
Plural
3 files
one locale at a time; Intl does the formatting, the catalogue only holds strings
triageI18n.setLocale('ar', { greeting: 'مرحباً {name}' });   // sets <html lang dir>
triageI18n.number(1234567.89);          // ١٬٢٣٤٬٥٦٧٫٨٩
triageI18n.percent(0.91);
triageI18n.date(new Date());            // locale month/day order
triageI18n.relative(-2, 'day');
triageI18n.list(['rules', 'flows']);    // "rules, flows" / "rules and flows"
triageI18n.plural(3, { one: '{n} file', other: '{n} files' });
triageI18n.load('/i18n/ar.json');       // { locale, messages }

Copy rules for bilingual products

  • Never concatenate sentences — use whole-message placeholders (t('filed', {name})) so word order can change per language.
  • Counts go through plural(): Arabic has six plural forms, Japanese one — English-style “s” logic breaks both.
  • Store ISO, display via Intl: dates as YYYY-MM-DD, numbers as raw values; formatting is a render concern.
  • Give first-class strings room: German adds ~35% width — let labels wrap, avoid fixed-width buttons.
  • Bidi hygiene: wrap embedded Latin identifiers in <bdi> or use dir="auto"; phone numbers and filenames are common offenders.
  • Terminology is part of the system: translate the voice page's verbs consistently (Enable/Disable, not On/Off).

Testing checklist

the same page in RTL is the fastest smoke test the system has
CheckHow
Directiontoggle a pseudo-locale or ar; look for physical margins, arrows that should mirror, clipped chips
Overflowrun the longest language (German/Russian) at the smallest supported width
Plurals0, 1, 2, 3, 11 for each locale — Arabic zero/dual/paucal forms differ
Formatsdates, times, currency, file sizes via Intl — never string-built
Bidifilenames, e-mail addresses and IDs inside RTL sentences
Static checksTDS013 flags physical properties in new CSS
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority. Source of truth: /tokens/tokens.json. Showcase chrome only: site/.