/i18n#

Context Framework Note: Activated for internationalization and multilingual support tasks.

Triggers#

• When adding new translation keys
• When managing multilingual text
• When using context.t.* patterns

Context Trigger Pattern#

/i18n {action} {key_path} [--options]

Parameters#

File Structure#

shared/i10n/lib/
├── translations/
│   ├── strings.i18n.yaml      # Base (Korean)
│   └── strings_en.i18n.yaml   # English
└── src/
    └── translations/
        └── translations.g.dart # Generated code

Translation File Format#

Basic Structure#

# shared/i10n/lib/translations/strings.i18n.yaml
common:
  appName: 펫메디
  ok: 확인
  cancel: 취소
  save: 저장
  loading: 로딩 중...
  error: 오류가 발생했습니다

auth:
  login: 로그인
  logout: 로그아웃
  signUp: 회원가입
  email: 이메일
  password: 비밀번호

Placeholders#

user:
  greeting:  ' $name님, 안녕하세요! ' 
   points:  ' $count 포인트 보유 ' 
   joinDate:  ' $date에 가입 '

Pluralization#

items:
  count(param=n):
    zero: 항목 없음
    one: 항목 1개
    other: 항목 $n개

messages:
  unread(param=count):
    zero: 읽지 않은 메시지 없음
    one: 읽지 않은 메시지 1개
    other: 읽지 않은 메시지 $count개

Context-Based#

pet:
  type(context=PetType):
    dog: 강아지
    cat: 고양이
    bird: 새

Code Usage#

Basic Usage#

// Using BuildContext extension
Text(context.t.common.appName)
Text(context.t.auth.login)
Text(context.t.home.title)

Placeholders#

Text(context.t.user.greeting(name: user.name))
Text(context.t.user.points(count: user.points.toString()))

Pluralization#

Text(context.t.items.count(n: itemCount))
Text(context.t.messages.unread(count: unreadCount))

Commands#

# Generate translation code
melos run generate:locale

# GPT auto-translation (English)
melos run generate:locale:gpt

# Check for missing translations
dart run slang analyze

Core Rules#

Naming Conventions#

• Use nested structures: user.profile.title
• Use camelCase
• Use meaningful key names

Translation Rules#

• All UI text must use translation keys
• Hard-coded strings are prohibited
• Pluralization must always be handled

Code Generation#

• Run melos run generate:locale after modifying translation files
• Do not manually edit generated code

MCP Integration#

Examples#

Add New Translation#

/i18n add home.newFeature --ko  " 새로운 기능 "   --en  " New Feature "

Add Plural Translation#

/i18n add cart.itemCount --ko  " 상품 "   --en  " item "   --plural

Check Missing Translations#

/i18n check

References#

• Detailed implementation: .claude/agents/i18n.md
• Translation files: shared/i10n/lib/translations/