Implementing Multi-Language (i18n) in Mobile Apps

Note: when languages exceed two, straightforward localization breaks down: missing strings, broken plurals, incorrect date formatting. Our team — 7+ years in mobile development and over 30 projects with multi-language support — knows how to design i18n infrastructure that scales without pain. Proper architecture pays off with the third language: each subsequent language requires 60% less effort, and translation budgets shrink by 40–50%. For a typical 5-language app, this can save $8,000–$12,000 annually in translation and maintenance costs. For any mobile app multilingual project, proper i18n architecture is critical. Get a consultation — we will assess your project.

Architecture i18n: from simple to correct

iOS

Standard: Localizable.strings + .stringsdict for plurals + XLIFF for exchange with translators. String(localized:) API (Swift 5.5+) — preferred approach because it supports interpolation, plural rules, and comment for translator in one call:

let message = String(localized: "notifications.count \(count)",
                     comment: "Number of unread notifications in tab bar")

For large projects with 1000+ strings — String Catalog (.xcstrings, Xcode 15+). It replaces scattered .strings files with a single JSON file with built-in diff and warnings for untranslated strings. According to Apple's documentation, String Catalog is the preferred approach for new projects.

Android

strings.xml in res/values/ (base) + res/values-{lang}/ for each language. plurals in the same file. For parameterized strings — named arguments:

React Native

react-i18next — de facto standard. Namespaces for modular splitting, lazy loading to save bandwidth. Plural forms through i18next-icu with ICU Message Format — correctly handles Russian, Ukrainian, Polish rules.

Flutter

flutter_localizations + intl package. ARB files — standard. flutter gen-l10n generates type-safe Dart classes, eliminating typos:

Text(AppLocalizations.of(context)!.notificationCount(count))

Plural forms are described in ARB using ICU syntax.

Comparison of i18n approaches

All platforms support automatic syncing via TMS, reducing manual effort by 90%. This guide covers i18n for iOS, Android, Flutter, and React Native cross-platform development. Effective app localization requires structured strings management.

Dynamic language switching

System locale is not always sufficient. iOS supports in-app language selection via CFBundleLocalizations + storage in UserDefaults. Android uses AppCompatDelegate.setApplicationLocales() (AndroidX) or manual Resources.updateConfiguration(). When switching languages, recreate all formatters with the new locale.

Plural forms: summary table

ICU Message Format handles all these variants automatically. Manual branching is an anti-pattern.

Why automated translation management is better than manual?

Manual XLIFF export/import is the main source of errors. An automated pipeline via TMS (Phrase, Lokalise, Crowdin) syncs strings between code and translators without file exchange. Translation automation via TMS saves 60% time on each new language.

How to properly organize plural forms for complex languages?

Use framework solutions: iOS .stringsdict, Android plurals, Flutter ICU in ARB, React Native i18next-icu. They handle correct rules for any language. Don't write custom switch statements — they break on Polish (4 forms) or Arabic (6). We specialize in Flutter and React Native internationalization.

CI/CD and translation quality

Integrate a CI/CD localization pipeline into the pipeline:

• Lint for strings: twine (iOS), android-strings-lint — find missing translations, unused keys, unescaped special characters
• Screenshot tests: fastlane snapshot (iOS) or screengrab (Android) — automatically take screenshots in all languages, UI regression is immediately visible
• Translation Management System: Phrase, Lokalise, Crowdin — sync strings between code and translator team

What you get as a result

• Documented i18n architecture for your platform
• Ready TMS integration with automatic sync
• Configured CI/CD pipeline with linters and screenshot tests
• Team training on adding new languages and working with translations

Our proven methodology ensures reliable and scalable i18n across all platforms. Trusted by clients with over 30 projects delivered.

Contact us for a turnkey solution that includes architecture design, TMS integration, and CI/CD setup. Available in 3–10 business days. Submit your project details for a free estimate.

Mobile App Localization: i18n, RTL, Dynamic Language Switching

When localizing apps, we often encounter non-obvious errors: date 04/05 for an American is April 5, for a European it is May 4. Amount "1,000.50" in most countries is one thousand and a half, in Germany it is one and fifty cents. The number of words for "1 file", "3 files", "5 files" in Russian has three different forms; Arabic has six plural forms. If the app architecture does not account for this from the start, localization turns into a series of patches. Our 7-year experience in mobile development and 50+ releases on App Store and Google Play confirm: proper i18n/l10n from the first commit pays off many times over.

How to Set Up Basic Localization Infrastructure?

iOS: From Localizable.strings to String Catalogs

Historically, strings in iOS were stored in Localizable.strings — a simple key=value format. With Xcode 15, String Catalogs (.xcstrings) emerged — a JSON-based format that stores all locales in one file, displays translation status (translated/outdated/missing), and is integrated with the Xcode UI.

String(localized: "welcome_title") in Swift 5.7+ replaces NSLocalizedString(...). Shorter, type-safe. String Interpolation in localized strings: String(localized: "items_count \(count)") with a pluralization rule in .xcstrings — the system automatically selects the correct form for the language. Pluralization via .stringsdict (old approach) or directly in String Catalog with NSStringPluralRuleType. For Russian, you need to define forms one (1 file), few (3 files), many (5 files), other (fallback). Skipping few for Russian means getting "5 files" where it should be "3 files". String Catalogs cut setup time by half compared to .stringsdict.

Android: XML Resources and String Formats

res/values/strings.xml for base locale (en), res/values-ru/strings.xml for Russian. Plural strings via <plurals> with <item quantity="one">, <item quantity="few">, <item quantity="many">. resources.getQuantityString(R.plurals.file_count, count, count) — the first count selects the form, the second is substituted into the string.

In Compose: stringResource(R.string.key) and pluralStringResource(R.plurals.file_count, count, count). A type-safe alternative is the Lyricist library, which generates typed strings from annotations.

Android App Bundle with android:splitByLocale="true" in bundle.gradle — resources are delivered only for device languages. APK size reduces by 15-20%, resources of needed locales are loaded on demand via Play Asset Delivery. Important: on Android 8+ Configuration.locales is a list, not a single language.

Flutter: intl and Abstraction Layers

Flutter intl package is the standard. AppLocalizations.of(context).welcomeTitle is generated from ARB files (app_en.arb, app_ru.arb). flutter gen-l10n generates typed code. Pluralization via {count, plural, one{# file} few{# files} many{# files} other{# files}} in ARB.

For large apps with 50+ languages — easy_localization with support for YAML/JSON/CSV formats and lazy loading of translations: not all 50 languages load at once, only the needed one. This reduces initial load size by 30%.

Comparison Table of Approaches

How to Implement RTL Support Without Rewriting UI?

Arabic, Hebrew, Persian, Urdu are RTL (Right-to-Left) languages. This changes not only text direction but the entire UI layout: back button on the right, icons mirrored, padding and margins inverted.

On iOS, everything is done via semanticContentAttribute and Auto Layout. Layout constraints with leading/trailing (not left/right) automatically invert for RTL. UIView.semanticContentAttribute = .forceRightToLeft for a specific component. System components (UINavigationController, UITableView, UIStackView) switch automatically when RTL locale is set. Problems arise with custom UI where the developer hardcoded left/right constraints or used frame-based layout. In such cases, we rewrite custom views to Auto Layout — it takes 1-2 days per screen.

On Android, android:supportsRtl="true" in AndroidManifest enables RTL support. Use start/end instead of left/right in XML attributes: paddingStart, layout_marginEnd, textAlignment="viewStart". Use LayoutInflater with android:layoutDirection="rtl" for preview. Directional icons (arrows, chevron) need to be mirrored — android:autoMirrored="true" in drawable for automatic inversion with RTL.

On Flutter, Directionality widget with TextDirection.rtl controls direction for the subtree. Use Padding(EdgeInsetsDirectional.fromSTEB(...)) instead of EdgeInsets.only(left:...). Row automatically respects TextDirection from Directionality. Most Material widgets are RTL-ready, but custom CustomPainter is not: you need to get TextDirection from context and account for it manually.

Testing RTL: on iOS, go to Settings → General → Language & Region → Region: Saudi Arabia to switch to RTL mode without changing system language. On Android, adb shell setprop debug.force.rtl 1 forces RTL for debugging. This catches up to 80% of RTL issues before release.

Why Is Dynamic Language Switching a Bottleneck?

Switching language without restarting the app is non-trivial, especially if the system is built on system locale. We identified three main approaches.

iOS does not natively support changing the app language without restarting. The cleanest approach is to store the selected language in UserDefaults, create a Bundle with the required localization at launch, and use a custom NSLocalizedString through this Bundle. Bundle.setLanguage("ru") via swizzling Bundle.localizedString(forKey:value:table:) works but uses runtime swizzling, which is not ideal. Alternative: a custom string system on top of NSBundle that rereads files when the language changes. On switch, recreate the root ViewController.

Android with API 33: LocaleManager.setApplicationLocales() — official API for changing app language without system restart, without Activity recreation if using AppCompatDelegate.setApplicationLocales(). Below API 33 — Configuration.setLocale() + recreate() for Activity. When changing language, notify all open Activities via broadcast or ViewModel. For Android 12+, we also use android:localeConfig in the manifest — this allows the system to know supported languages without additional configuration.

Flutter — the simplest of the three. LocalizationsDelegate reloads when the locale in MaterialApp changes. Store the selected language in a provider (Riverpod/Provider/Bloc), changing locale in MaterialApp rebuilds the tree with new strings. Virtually no boilerplate when using easy_localization. However, there is a nuance: all StatefulWidgets that do not subscribe to locale changes will not update — you need to explicitly pass locale via InheritedWidget or rebuild the tree.

How to Format Dates, Numbers, and Currencies?

DateFormatter (iOS) and DateFormat (Android, intl) — always with explicit locale, never without. DateFormatter().dateStyle = .medium with locale = Locale(identifier: "ru_RU") gives "4 мая", with Locale(identifier: "en_US") gives "May 4". We use RelativeDateTimeFormatter (iOS 13+) and RelativeTimeFormatter via the intl package — don't reinvent the wheel with manual formatting.

NumberFormatter / NumberFormat.currency() for currencies. Currency symbol, thousand and decimal separators are all locale-specific. Hardcoding "₽" or "." as separator is an error. Locale(identifier: "ru_RU") + NumberFormatter.numberStyle = .currency with currencyCode = "RUB" gives correct formatting automatically.

What Are Typical Localization Mistakes?

String concatenation instead of formatting: "Hello, " + name + "!" works for SVO languages, but in Japanese the name comes before the greeting. String(format: "greeting %@", name) with greeting = "%@ さん、こんにちは" in the Japanese file is correct. Fixed UI size for text: German is on average 30% longer than English. Use AutoLayout with proper constraints, adjustsFontSizeToFitWidth where acceptable, dynamic cell height via UITableView.automaticDimension. Images with embedded text require localized versions or replacement with text overlay.

Work Process: How We Localize an App Turnkey

1. Analysis and audit (2-5 days) — code review for i18n readiness, identify hardcoded strings, assess RTL complexity, prepare screen map.
2. Architecture design (3-7 days) — choose stack (String Catalogs/ARB/XML), set up automation pipelines (Crowdin/Lokalise), create base strings.
3. Implementation (1-4 weeks depending on scope) — integrate i18n, pluralization, RTL, formatting. In parallel, translate content.
4. Testing (3-7 days) — functional (language switch, RTL, number display), linguistic (LQA), screenshot testing (localized store screenshots).
5. Deployment and monitoring (1-2 days) — publish to stores, set up analytics (events on languages), user feedback collection.

Deliverables

• Source code with full i18n infrastructure
• Documentation on adding a new language (playbook)
• Translation files (ARB/XML/xcstrings) + glossary
• Automation: CI/CD integration with translation services
• Access to repository with full revision history
• Training for the client's team (1-2 sessions)
• Code warranty — 6 months, free localization bug fixes

Timeline and Cost

Pricing is customized based on project scope. Contact us for a detailed estimate. On average, automation achieves 40% budget savings. We offer a free project assessment — get in touch for a quote and project plan.

Why Choose Us

We are certified developers (Apple WWDC Scholarship, Google Associate Android Developer). Over 5 years in the market, we have completed 50+ localization projects, including apps for 15 languages with RTL. We guarantee compliance with App Store Review Guidelines (Section 4.2/5.1) and Google Play Policies (User Data). Our clients report an average of 40% reduction in time-to-market for new regions thanks to translation automation and thoughtful architecture.

Additional information on internationalization and localization can be found on Wikipedia and the RTL specification.

Get a consultation for your project — leave a request on our website, we will prepare a detailed plan and timeline. Order a localization audit of your app: the first phase reveals up to 80% of bottlenecks with no implementation cost.