iOS Localization & Assets

Priority: P1

Implementation Workflow

1. Use String Catalogs — Adopt .stringcatalog files in Xcode 15+ for visual editing and compile-time missing translation checks.
2. Prefer modern APIs — Use String(localized: "key") or LocalizedStringResource instead of NSLocalizedString.
3. Handle pluralization — Use String Catalogs' built-in pluralization instead of custom code logic.
4. Format with locale — Use Formatted API for dates, numbers, and currencies to respect user locale.
5. Organize assets — Use .xcassets with "Provides Namespace" enabled. Prefer SF Symbols for standard icons.
6. Complete Base localization — Ensure Base is complete before adding other languages.

See localization and asset catalog examples

Anti-Patterns

• ❌ Manual currency symbol concatenation — use NumberFormatter or .formatted(.currency)
• ❌ Loose png/jpg files in repo — always use Asset Catalogs
• ❌ Placeholder strings left in String Catalogs — ensure 100% translation coverage

References

• L10n & Asset Organization