Skip to main content

Tolgee iOS SDK Overview

NOTE: For managing static translations in your repository, consider using the Tolgee CLI.

Tolgee iOS (and macOS) SDK makes it possible to deliver new translations from your Tolgee project directly to your application. This means you don’t need to release a new version through the App Store just to update localizations. With over-the-air updates, translations can be refreshed seamlessly in your app without requiring a manual update.

Why use it​

  • Avoid releases for copy changes: Ship translation fixes and new languages without a new app build.
  • Faster iteration: Product/localization teams can push improvements instantly and validate in production.
  • SwiftUI support: You can still use features such as overwriting locales for your SwiftUI previews.
  • Resilient by default: Works offline with caching and resource fallbacks; fewer blank strings.

What you can do​

  • Over‑the‑Air (OTA) updates: Deliver translations via CDN (Cloud or self‑host) with caching.
  • UIKit and SwiftUI support: with hooks for reactive updates of translations.
  • Fallbacks and preloading: The SDK will fallback to loading a translation bundled with your app in case of any error.
  • Hosting options: Tolgee Cloud CDN or your own CDN.
  • Works with advanced codebases: you can still have your translations split into multiple files and have them stored in a separate framework/package.

Demo apps​

Compatibility​

The SDK currently supports iOS 16.0+ and macOS 13.0+ with integration via Swift Package Manager (SPM).

NOTE: Please reach out to us if you need support for older OS versions or integration through CocoaPods, we are happy to look into it.

Get started​

  • Installation: Install and configure the SDK — Installation
  • SwiftUI compatibility: Learn how Tolgee iOS SDK works with your SwiftUI code — SwiftUI
  • NSLocalizedString swizzling: Learn how to achieve zero config integration by enabling method swizzling — Swizzling
  • Advanced usage: Tips and tricks for debugging and using the SDK with advanced codebases — Advanced usage

Next steps​

  • Install and configure the SDK: Installation
  • Connect your app to the Tolgee Platform and manage translations collaboratively: Platform docs
  • Generate or manage static strings with CLI: Tolgee CLI