| name | i18n |
| updated | "2026-02-11T00:00:00.000Z" |
| description | Add or update translations across all 7 locale files and wire them into React components or pure utility functions. |
| argument-hint | ["scope description"] |
| allowed-tools | Read, Edit, Write, Glob, Grep |
i18n — Internationalization Skill
Arguments
$0 - What to translate (e.g., "DRep dashboard labels", "new filter buttons")
Quick Reference
Locales: en, de, fr, es, pt, ja, zh — files at src/messages/{locale}.json
Library: next-intl — useTranslations("namespace") in components, typed labels object for lib/ utilities
CRITICAL: All 7 files must stay in sync. Missing keys cause runtime errors.
Procedure
- Grep for the insertion point in
en.json (find neighboring keys)
- Read just those lines (offset/limit) across all 7 files
- Edit all 7 files — add key after the neighboring key
- Wire up in component:
const t = useTranslations("namespace"); t("key")
Namespaces
| Namespace | Purpose |
|---|
common | Shared UI: loading, retry, search, showMore |
meta | Page titles/descriptions |
landing | Landing page |
dashboard | Dashboard page |
stats | Stat cards |
status | Status labels: Active, Ratified, Enacted |
actionTypes | NoConfidence, UpdateCommittee, etc. |
filters | Filter UI |
table | Table headers |
voting | drep, spo, cc, yes, no, abstain, threshold |
charts | Dashboard chart titles |
sort | Sort controls |
proposal | Proposal detail page |
export | Export file labels |
drep | DRep dashboard |
drep.profile | DRep profile page |
tabs | Tab labels |
expiry | Proposal expiry |
errors | Error states |
download | Download dropdown |
accessibility | Screen reader labels |
Max one nesting level (e.g., charts.proposalStatus.title).
Project Conventions — What Stays English
- Landing page filter dropdown labels
- Action type names and status values on proposal cards
- Machine-readable values (API constants, JSON export keys, tx hashes)
- Technical terms: DRep, SPO, ADA, CC — English in all locales
Translation Guidelines
- Natural fluent translations, not word-for-word
- CJK (ja, zh): no spaces, appropriate particles
- Portuguese: European (pt-PT)
- Interpolation: ICU syntax
"Show {count} more" — ensure {count} in all locales
- CSV export: prepend UTF-8 BOM (
"\uFEFF") for Excel compatibility
Pattern: Labels for lib/ Utilities
Functions in lib/ can't use hooks. Pass a typed labels object from the component:
export interface ExportLabels { noRationale: string; voteYes: string; }
export function exportToCSV(data: Data[], labels: ExportLabels) { ... }
const labels: ExportLabels = useMemo(() => ({
noRationale: t("noRationale"), voteYes: t("voteYes"),
}), [t]);
Key Rules
- Always use original English values for styling/logic (
getVoteBadgeClasses(vote.vote)), translated values only for display
useLocale() for date/number formatting: new Date(ts).toLocaleDateString(locale, {...})
