skillfed

localization-setup

Localization Setup generates the foundation for supporting multiple languages in iOS and macOS applications. It guides you through creating String Catalogs, establishing type-safe string access patterns, and configuring pluralization and device-specific content. The skill handles migration from legacy approaches and includes SwiftUI preview helpers for testing across locales.

Localization Setup generates i18n infrastructure for multi-language iOS/macOS app support using String Catalogs and type-safe patterns.

AI-generated summary based on this skill's SKILL.md

565 47 MIT updated by rshankras

Install

rshankras/claude-code-apple-skills/localization-setup · repository language: Swift

CLI (skillfed)coming soon
git clone https://github.com/rshankras/claude-code-apple-skills
cp -r claude-code-apple-skills/skills/generators/localization-setup ~/.claude/skills/localization-setup

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I set up localization in an iOS app?

Localization Setup provides comprehensive guidance for establishing internationalization infrastructure in iOS applications. The skill walks you through creating String Catalogs in Xcode, configuring language support, and setting up type-safe localized string access patterns. You'll learn to organize localization files, configure supported languages in your project settings, and implement SwiftUI preview helpers to test your app across different locales before deployment.

What's the difference between String Catalogs and .strings files?

Localization Setup covers the migration path from legacy .strings files to modern String Catalogs (.xcstrings). String Catalogs provide a unified, type-safe approach to managing localizations with built-in support for pluralization, device-specific content, and better tooling integration. The skill guides you through converting existing .strings files to String Catalogs while maintaining your translation workflows and ensuring no localization data is lost during migration.

How can I add type-safe localized string access to my Swift app?

Localization Setup teaches you to generate type-safe localized string access patterns that eliminate string key typos and provide compile-time verification. Using String Catalogs, Xcode automatically generates strongly-typed accessors for your localized strings. The skill shows how to structure your localization infrastructure so that accessing translated content feels natural in your code while maintaining safety and discoverability through IDE autocomplete.

How do I support RTL languages and pluralization?

Localization Setup configures right-to-left language support and pluralization rules for your iOS or macOS app. The skill guides you through defining plural forms for different languages, handling gender-specific variations, and enabling automatic RTL layout mirroring in SwiftUI and UIKit. You'll learn language-specific pluralization patterns and how to preview your app's layout in RTL languages to catch design issues early.

How do I prepare localization files for translation teams?

Localization Setup helps you export and organize localization files in formats that translation teams expect. The skill covers exporting String Catalogs for external translation, managing translation workflows, and re-importing completed translations back into your Xcode project. You'll establish best practices for providing context to translators, managing multiple language variants, and maintaining consistency across your localization assets.

Can I preview my SwiftUI app in different languages?

Localization Setup includes SwiftUI preview helpers that let you test your app's appearance and layout across multiple languages and locales without rebuilding. The skill shows how to configure preview modifiers that simulate different language environments, including RTL layouts and varying text lengths. This approach helps you catch localization issues early in development and ensures your UI adapts properly to different language characteristics.

SKILL.md

rendered from the published skill — quoted content, verbatim

Localization Setup Generator

Generate internationalization (i18n) infrastructure for multi-language support in iOS/macOS apps.

When This Skill Activates

  • User wants to localize their app for multiple languages
  • User mentions i18n, internationalization, or localization
  • User asks about String Catalogs or .strings files
  • User wants to support RTL (right-to-left) languages

Pre-Generation Checks

Before generating, verify:

  1. Existing Localization bash # Check for existing localization files find . -name "*.xcstrings" -o -name "Localizable.strings" 2>/dev/null | head -5 find . -name "*.lproj" -type d 2>/dev/null | head -5

  2. Deployment Target ```bash # String Catalogs require iOS 16+ / macOS 13+ grep -r

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 5 files
skills/generators/localization-setup/SKILL.md
skills/generators/localization-setup/localization-patterns.md
skills/generators/localization-setup/templates/LocalizationManager.swift
skills/generators/localization-setup/templates/LocalizedPreview.swift
skills/generators/localization-setup/templates/LocalizedStrings.swift

Related skills

Tags

multi-language-support string-catalog-migration rtl-language-handling type-safe-localization translation-workflow locale-preview-testing pluralization-rules xcode-localization-tools internationalization-infrastructure