React Native SDK - Version History

This page documents all changes to the GetTranslated React Native SDK. For installation instructions and usage guide, see the React Native Quick Start Guide.

The SDK follows Semantic Versioning:

• MAJOR (X.0.0): Breaking changes
• MINOR (0.X.0): New features, backward compatible
• PATCH (0.0.X): Bug fixes, backward compatible

Version 1.2.0 - January 21, 2026

Release Date: January 21, 2026

Type: Minor Release

Changed

• Improved loading state: The t() function now returns empty strings instead of translation keys when translations are not yet loaded, preventing key flashing in the UI
• Better error handling: Translation methods now consistently return empty strings on errors instead of throwing or returning keys

Fixed

• Race condition protection: Added instance validation checks in background sync to prevent state updates when instance changes during async operations (e.g., during login/logout)
• Translation result handling: Fixed edge case where valid translations that happen to equal the key were incorrectly treated as missing translations
• Error handling consistency: All translation error paths now return empty strings for consistent loading state behavior

View on NPM →

Version 1.1.0 - December 9, 2025

Release Date: December 9, 2025

Type: Minor Release

Added

• Non-blocking initialization: When resources are provided, the SDK initializes immediately without waiting for network requests, allowing apps to load instantly
• Background server sync: Server synchronization now happens asynchronously in the background after immediate initialization, preventing blocking delays
• Offline mode tracking: New isOfflineMode() method and isOfflineMode property in useTranslation() hook to track when SDK is operating offline
• Always render children: TranslationProvider now always renders children immediately instead of waiting for initialization, improving perceived performance

Changed

• Initialization behavior: Apps with provided resources now load immediately and sync with server in background, eliminating network timeout delays
• Base language detection: Improved base language selection to use device language detection instead of assuming English

Fixed

• Offline initialization: Fixed issue where apps wouldn't load if device was offline or server unreachable when resources were provided
• Network timeout blocking: Removed blocking network timeout wait when resources are available, allowing instant app startup

View on NPM →

Version 1.0.7 - 2025

Release Date: 2025

Type: Patch Release

Changed

• Bug fixes and improvements

View on NPM →

Version 1.0.0 - 2025

Release Date: 2025

Type: Initial Release

Added

• Initial release of GetTranslated React Native SDK
• Translation management and synchronization
• Language detection and switching
• Translation caching with AsyncStorage
• Integration with i18next and react-i18next
• TranslationProvider component for React Native apps
• Support for dynamic translations
• TypeScript support with full type definitions

View on NPM →

Installation

To install or upgrade to the latest version:

npm install @gettranslated/react-native-sdk

To install a specific version:

npm install @gettranslated/[email protected]

Reporting Issues

Found a bug or have a feature request? Please contact us at [email protected] or visit our quick start guide.