Skip to main content

Tolgee Android SDK

info

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

Overview​

Tolgee Android SDK for Android and Compose Multiplatform lets you localize Kotlin-based applications with dynamic content delivery, adapting content to user behavior, preferences, and device data.

Supports Over‑the‑Air (OTA) translation updates, providing translations dynamically without needing to publish new app versions.

The platform works offline with caching, fallbacks, device-aware resource selection, and preloading of critical namespaces for a smooth user experience. Tolgee keeps UX consistent by updating the UI automatically in response to locale changes, resulting in fewer untranslated or mismatched strings.

info

Tolgee gives you multiple hosting options: Cloud CDN (Cloud or self‑hosting) or your own CDN.

Modules​

Tolgee Android SDK is split into modules so you only add what you need.

When to use which module​

  • Core

    • Use with traditional Android Views or any non-Compose UI.
    • Provides content delivery (CDN), key lookup, formatting (Sprintf/ICU), caching.
    • Start here if you don't use Jetpack Compose.

  • Compose

    • Use with Jetpack Compose or Compose Multiplatform.
    • Adds localized composables and helpers (e.g., stringResource, pluralStringResource).
    • Requires core transitively.

Features​

  • Core

    • Over-the-air updates: Update your translations without releasing a new app version.
    • Multiple format support: Sprintf (Android SDK) formatting, ICU (Tolgee Native Flat JSON) formatting.
    • Kotlin Multiplatform: Designed with multiplatform support in mind.
    • Android integration: Seamless integration with Android resources.
    • Dynamic locale switching: Change languages at runtime.

  • Compose

    • Compose Integration: Use Tolgee translations in your Compose UI with familiar APIs.
    • Android Resource Support: Seamless integration with Android string resources.
    • Parameter Support: Pass parameters to your translations.
    • Plural Support: Handles plural forms.
    • Reactive Updates: UI automatically updates when translations or locale change.

Demo apps​

📱 Android Views Demo​

Complete example implementation using Android Views

🚀 Jetpack Compose Demo​

Complete example implementation using Jetpack Compose

🌐 Compose Multiplatform Demo​

Complete example implementation using Compose Multiplatform

Get Started​

Ready to integrate Tolgee into your Android project?

🚀 Get Started Guide

Complete step-by-step setup guide with installation, modules, and implementation choices

Start Here