Skip to content

STD-COD-002: Internationalization (I18n)

1. Context

To ensure the platform is accessible to Spanish and English speakers without UI regressions.

2. The Standard (The Floor)

  • [MUST] No Hardcoded Strings: User-facing text MUST use useTranslations(). Never output string literals in JSX.
  • [MUST] Symbol Localization: Even symbols (✕, ★) MUST be localized via t().
  • [MUST] Keys First: Define keys in messages/en.json before usage.
  • [MUST] Strict Linting: All builds MUST pass eslint-plugin-i18next checks.

3. Best Practices (The Path)

  • [SHOULD] Symmetric Keys: Ensure es.json matches en.json structure (use audit:i18n).
  • [SHOULD] Namespace Grouping: Group keys by component or page (e.g., Directory.Unit...).

5. Version History

Version Date Author Change
1.0 2026-01-25 AI Extracted from .cursorrules

Version History

Version Date Author Change
0.1.0 2026-01-26 Antigravity Initial Audit & Metadata Injection