aissat/easy_localization
Easy Localization
Easy Localization is a framework for managing multi-language support in mobile applications. It provides a comprehensive system for loading translation datasets from local or remote sources, organizing them into modular files, and rendering localized content dynamically. The library integrates with the application's dependency injection system to broadcast locale changes, enabling reactive interface updates without requiring a full application restart.
The project distinguishes itself through a focus on development safety and maintenance. It includes command-line tools to audit source code for missing translation keys and generates type-safe constants from translation files, which enables IDE autocompletion and prevents runtime errors. It also supports complex translation requirements, including nested path-based resolution, gender-specific variations, and pluralization rules that adapt to specific language grammar.
Beyond core translation, the library handles region-specific data formatting, such as converting numbers, currencies, and percentages into localized formats. It manages persistent user preferences to maintain language settings across sessions and provides diagnostic logging capabilities to monitor localization processes during development and production.
Features
- Internationalization and Localization - Provides a comprehensive framework for managing multi-language support, translation files, and dynamic locale switching in mobile applications.
- String Localization - Retrieves translated strings for specific keys, supporting dynamic argument injection, pluralization, and gender-specific variations.
- Flutter - Manages multi-language support in mobile applications with dynamic locale switching, pluralization, and external translation file loading.
- Type-Safe Translation Keys - Generates type-safe constants from translation files to enable IDE autocompletion and prevent runtime key errors.
- Widget Tree Providers - Propagates locale changes and translation data through the widget tree using dependency injection for reactive UI updates.
- Internationalization Frameworks - Translates application content into multiple languages while supporting locale-specific formatting and dynamic argument injection.
- Application Locale Management - Manages the active application language, allowing dynamic switching, persistence, and retrieval of current locale settings.
- Locale-Aware Date and Number Formatting - Converts numbers, currencies, and percentages into region-specific formats for international users.
- Number Parsing - Converts numeric values into localized strings and parses formatted strings back into numbers using locale-specific rules.
- Translation Namespace Loading - Loads translation data from local files or remote network resources to support diverse application language requirements.
- Path-Based Resolvers - Retrieves deeply structured translation values using simple path notation to keep large localization files organized.
- Mobile Application Localizations - Organizes and maintains large sets of translated strings, pluralization rules, and gender-specific content for mobile applications.
- Locale Translation Files - Supports organizing translation datasets into modular, external files to maintain clean project structures.
- Asynchronous Asset Loading - Loads translation datasets asynchronously from local or remote sources to prevent blocking the main application thread during startup.
- Compile-Time Code Generation - Generates type-safe constants from translation files during the build process to enable IDE autocompletion and prevent runtime key errors.
- Pluralization Rules - Selects appropriate translation forms based on numeric values and specific language grammar rules.
- Nested Key Resolution - Retrieves localized content by traversing nested data structures using path-based key resolution.
- Selective Widget Rebuilding - Triggers targeted widget tree refreshes when the active language changes to update text without requiring a full application restart.
