Internationalization (i18n)

Guidelines for internationalization and translation management.

Critical Restrictions

ABSOLUTELY FORBIDDEN (auto-generated files):

// ❌ NEVER modify auto-generated translation files
// These are typically generated from a translation management system

// ❌ NEVER hardcode text strings
<Text>Confirm</Text>

// ✅ CORRECT - Always use translation keys
import { ETranslations } from '@{scope}/shared/src/locale';
intl.formatMessage({ id: ETranslations.global__confirm })

Consequences of violation:

• •Translation system corruption
• •Loss of translation work
• •Build failures in i18n pipeline
• •Breaking localization for international users

Quick Reference

Using Translations in Components

import { useIntl } from 'react-intl';
import { ETranslations } from '@{scope}/shared/src/locale';

function MyComponent() {
  const intl = useIntl();

  return (
    <Text>
      {intl.formatMessage({ id: ETranslations.global__confirm })}
    </Text>
  );
}

Using formatMessage Outside Components

import { appLocale } from '@{scope}/shared/src/locale/appLocale';
import { ETranslations } from '@{scope}/shared/src/locale';

const message = appLocale.intl.formatMessage({
  id: ETranslations.global__cancel,
});

Translation Workflow

1. •Design provides translation key like prime::restore_purchases
2. •Run sync command: yarn fetch:locale
3. •Convert key format: prime::restore_purchases → ETranslations.prime_restore_purchases
4. •Use in code:
   tsx

   {intl.formatMessage({ id: ETranslations.prime_restore_purchases })}
   

Translation Key Naming Pattern

namespace__action_description

Examples:
- global__confirm
- global__cancel
- swap__select_token
- wallet__create_wallet
- settings__dark_mode

Detailed Guide

For comprehensive i18n guidelines and examples, see i18n.md.

Topics covered:

• •Translation management restrictions
• •Using translations in components
• •Translation key naming conventions
• •Locale handling and fallbacks
• •Code examples
• •Workflow summary

Key Files (Example Structure)

Related Skills

• •/date-formatting - Date formatting with locale support
• •/coding-patterns - General coding patterns