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| Check | How |
|---|---|
| Direction | toggle a pseudo-locale or ar; look for physical margins, arrows that should mirror, clipped chips |
| Overflow | run the longest language (German/Russian) at the smallest supported width |
| Plurals | 0, 1, 2, 3, 11 for each locale — Arabic zero/dual/paucal forms differ |
| Formats | dates, times, currency, file sizes via Intl — never string-built |
| Bidi | filenames, e-mail addresses and IDs inside RTL sentences |
| Static checks | TDS013 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/.