KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

TranslateKitSDK

★ 214 Open GitHub ↗

SF Symbols for Texts: 2000+ built-in translations in 40 languages + semantic localization key macro for Swift devs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![TranslateKit SDK Logo](https://github.com/FlineDev/TranslateKit/blob/main/Logo.png?raw=true)

[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2FFlineDev%2FTranslateKitSDK%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/FlineDev/TranslateKitSDK)

# TranslateKit SDK

What SF Symbols is for Icons, TranslateKit is for Text!

Eliminate localization overhead in your Swift apps with 2000+ pre-localized strings and semantic key generation. Make app localization simple, accurate, and delightful.

## Key Features

### 1. Pre-localized Common Strings
Access 2,000+ ready-to-use strings in ~40 Apple platform languages across four categories. These match the [officially supported iOS system languages](https://www.apple.com/ios/feature-availability/#system-language-system-language) and utilize Apple's own translations where available, ensuring consistency with the system UI.

Since they are pre-localized, they won't add entries to your String Catalog – just use them directly:

```swift
// Actions: Interactive UI elements
Button(TK.Action.save) { saveData() }  // "Save" → "Sichern" (German)

// Labels: Non-interactive text
Label(TK.Label.notifications, systemImage: "bell")  // "Notifications" → "Benachrichtigungen"

// Placeholders: Temporary text
TextField(TK.Label.firstName, text: $firstName,  // "First Name" → "Vorname"
         prompt: TK.Placeholder.firstNameExample)  // "e.g. Jane" → "z.B. Erika"

// Messages: Full sentences
Text(TK.Message.anErrorOccurred)  // "An Error Occurred" → "Ein Fehler ist aufgetreten"
```

Discovering the right translations is effortless with autocompletion – type `TK.` to explore categories and fuzzy-match strings, with English previews and usage hints in the documentation popover:

![Showcasing Autocompletion in Xcode](https://github.com/FlineDev/TranslateKit/blob/main/Images/Autocomplete.jpeg?raw=true)

### 2. Smart Key Generation
The `#tk` macro eliminates the tedious work of manual key management by automatically generating semantic keys based on code context:

```swift
struct SettingsView: View {
  let documentName: String
    
  var body: some View {
    // Generates key: SettingsView.Body.saveChanges
    Button(#tk("Save Changes")) { handleSave() }
        
    // Add context with 'c' parameter to help translators
    Text(#tk("Save changes to \(documentName)?", 
             c: "e.g. 'Save changes to MyNumbers.csv'"))
  }
}
```

String Catalogs made it challenging to maintain best practices from the Strings-file era, where using semantic keys helped group related translations. The macro brings back this advantage while keeping String Catalogs' benefits - you get semantic keys without writing verbose `String(localized:defaultValue:comment:)` calls:

![Macro Expansion in Xcode](https://github.com/FlineDev/TranslateKit/blob/main/Images/MacroExpansion.jpeg?raw=true)

You can see in the image what the simple `#tk` macro call expands to, adding an auto-derived key. These semantic keys help group related translations and provide crucial context to translators and translation tools (like the [TranslateKit Mac app](https://translatekit.app)), leading to more accurate translations while making your localization files easier to maintain.

### Core Strings & Category-Specific Extensions

To keep TranslateKit lightweight while providing comprehensive coverage, the 2,000+ pre-localized strings are organized into two tiers:

1. **Core Strings (250+):**  
   Included in the base `TranslateKit` package, these strings are commonly used across all kinds of apps, making them universally applicable.

2. **Category-Specific Extensions (~100 per category):**  
   Each of the **26 App Store categories** has an additional module with strings tailored to that category. For example:
   - **Finance apps:** `import TranslateKitFinance`
   - **Productivity apps:** `import TranslateKitProductivity`
   - **Health & Fitness apps:** `import TranslateKitHealthAndFitness`
   
   These modules also include the core strings, so you only need to import the one matching your app category.

With this modular approach, TranslateKit remains lightweight, adding only ~1MB to your app, making it suitable for any project – big or small.

## Swift Package Usage

For Swift packages, use `#tkm` instead of `#tk` to reference the correct String Catalog file:

1. Add `defaultLocalization` to your manifest:
```swift
let package = Package(
   name: "FormKit",
   defaultLocalization: "en",
   // ...
)
```

2. Add `Localizable.xcstrings` to your module (right-click folder > "New File from Template…" > String Catalog)

3. Use the `#tkm` macro with optional comment:
```swift
struct FormValidator {
   static func validatePassword(_ password: String) -> String? {
       guard password.count >= 8 else {
           return #tkm("Password must be at least 8 characters")
       }
       return nil
   }
}
```

Common reasons to localize Swift packages are that they may contain UI elements (e.g. modularized apps) or that they might provide error descriptions, which should be localized in most cases.

## Solving Macro Trust Issues in Xcode Cloud

If you're using Xcode Cloud or experiencing issues with macro trust, check out our guide [Solving Swift Macro Trust Issues in Xcode Cloud Builds](https://www.fline.dev/solving-swift-macro-trust-issues-in-xcode-cloud-builds/). This article explains how to properly configure your build settings when CI systems don't automatically trust macro packages.

## Using TranslateKit without Macros

If you don't want to use the `tk` macro but still profit from the community-driven common strings in your app, you can also opt for one of the `Lite` targets instead of the regular ones. For example, instead of adding and importing the `TranslateKit` target to your app, you can instead add & import `TranslateKitLite`. For category-specific variants, instead of something like `TranslateKitGames`, use `TranslateKitGamesLite`.

The `Lite` variants of the targets ensure that Xcode (and CI workflows) won't ask you to "Trust & Enable" macros in TranslateKit. But they also lack the added context you get when using `#tk` macro. We include these macros by default because we recommend everyone using them, but the `Lite` targets give you a way to opt-out when needed.

## Contributing

Contributions – especially additions and corrections – are welcome!

Please feel free to submit a Pull Request. You don't need to localize added entries to all languages yourself, just provide the one(s) you speak, we'll take care of the other languages using [TranslateKit](https://translatekit.app). But please keep the entries sorted alphabetically when adding new ones!

For bigger changes, please open an issue first to discuss what you would like to change.

## Showcase

I created this library for my own Indie apps (download & rate them to show your appreciation):

<table>
 <tr>
 <th>App Icon</th>
 <th>App Name & Description</th>
 <th>Supported Platforms</th>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6476773066?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/TranslateKit.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6476773066?pt=549314&ct=github.com&mt=8">
 TranslateKit: App Localization
 </a>
 
 AI-powered app localization with unmatched accuracy. Fast & easy: AI & proofreading, 125+ languages, market insights. Budget-friendly, free to try.
 </td>
 <td>Mac</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6502914189?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/FreemiumKit.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6502914189?pt=549314&ct=github.com&mt=8">
 FreemiumKit: In-App Purchases for Indies
 </a>
 
 Simple In-App Purchases and Subscriptions: Automation, Paywalls, A/B Testing, Live Notifications, PPP, and more.
 </td>
 <td>iPhone, iPad, Mac, Vision</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6587583340?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/PleydiaOrganizer.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6587583340?pt=549314&ct=github.com&mt=8">
 Pleydia Organizer: Movie & Series Renamer
 </a>
 
 Simple, fast, and smart media management for your Movie, TV Show and Anime collection.
 </td>
 <td>Mac</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6480134993?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/FreelanceKit.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6480134993?pt=549314&ct=github.com&mt=8">
 FreelanceKit: Project Time Tracking
 </a>
 
 Simple & affordable time tracking with a native experience for all devices. iCloud sync & CSV export included.
 </td>
 <td>iPhone, iPad, Mac, Vision</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6472669260?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/CrossCraft.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6472669260?pt=549314&ct=github.com&mt=8">
 CrossCraft: Custom Crosswords
 </a>
 
 Create themed & personalized crosswords. Solve them yourself or share them to challenge others.
 </td>
 <td>iPhone, iPad, Mac, Vision</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6477829138?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/FocusBeats.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6477829138?pt=549314&ct=github.com&mt=8">
 FocusBeats: Pomodoro + Music
 </a>
 
 Deep Focus with proven Pomodoro method & select Apple Music playlists & themes. Automatically pauses music during breaks.
 </td>
 <td>iPhone, iPad, Mac, Vision</td>
 </tr>
 <tr>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6478062053?pt=549314&ct=github.com&mt=8">
 <img src="https://raw.githubusercontent.com/FlineDev/HandySwiftUI/main/Images/Apps/Posters.webp" width="64" />
 </a>
 </td>
 <td>
 <a href="https://apps.apple.com/app/apple-store/id6478062053?pt=549314&ct=github.com&mt=8">
 Posters: Discover Movies at Home
 </a>
 
 Auto-updating & interactive posters for your home with trailers, showtimes, and links to streaming services.
 </td>
 <td>Vision</td>
 </tr>
</table>

TranslateKitSDK

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README