---

name: localization description: 'Multi-platform localization (iOS, Android, Flutter). Sử dụng skill này khi setup localization mới, thêm text, hoặc cần best practices về đa ngôn ngữ.'

Localization Skill

Multi-platform localization guide cho iOS, Android và Flutter

---

🎯 Khi Nào Sử Dụng Skill Này

---

📐 Architecture Overview

Copy┌─────────────────────────────────────────────────┐
│  Presentation Layer                             │
│  ├── View (hiển thị L10n.key)                   │
│  └── ViewModel (@Published currentLocale)        │
├─────────────────────────────────────────────────┤
│  Data Layer                                     │
│  └── LocaleStorage (UserDefaults/SharedPrefs)   │
└─────────────────────────────────────────────────┘

Core Principles

1. Separation of Concerns - Locale state trong ViewModel/Provider
2. Type Safety - Code generation (SwiftGen, R.string, AppLocalizations)
3. Dynamic Switching - Runtime language change
4. Persistence - Save user preference
5. Fallback - Luôn có base language (English)

---

📱 Platform Quick Reference

---

📋 Key Naming Convention

iOS (dot.notation)

Copylogin.title
login.email.placeholder
login.button.sign_in
login.error.invalid_credentials

Android (snake_case)

Copy<string name="login_title">Đăng nhập</string>
<string name="login_email_placeholder">Email</string>
<string name="login_button_sign_in">Đăng nhập</string>

Flutter (camelCase)

Copy{
  "loginTitle": "Đăng nhập",
  "loginEmailPlaceholder": "Email",
  "loginButtonSignIn": "Đăng nhập"
}

---

🚀 Quick Workflows

1. Setup Localization (Dự án mới)

iOS:

Copy# 1. Install SwiftGen
brew install swiftgen

# 2. Create Localizable.strings
mkdir -p Resources/en.lproj
touch Resources/en.lproj/Localizable.strings

# 3. Configure swiftgen.yml
# 4. Run: swiftgen

Android:

Copy# 1. Create strings.xml
mkdir -p app/src/main/res/values
touch app/src/main/res/values/strings.xml

# 2. Add base strings
# 3. Android Studio auto-generates R.string

Flutter:

Copy# 1. Add to pubspec.yaml
flutter:
  generate: true

# 2. Create l10n.yaml
# 3. Create lib/l10n/app_en.arb
# 4. Run: flutter gen-l10n

2. Thêm Text Mới

Copy1. Xác định key name theo convention
2. Thêm vào base language file
3. Run code generation
4. Sử dụng trong code
5. Thêm translations cho các ngôn ngữ khác

---

✅ Best Practices Checklist

• Key names descriptive và hierarchical
• Base language (EN) luôn complete
• Plurals sử dụng proper rules (ICU format)
• Date/number formatting theo locale
• RTL support nếu cần (Arabic, Hebrew)
• String interpolation với named parameters
• No hardcoded strings trong code

---

📁 Reference Files