language_excel_localization 0.0.3

A code-generation Flutter localization package that reads an Excel sheet and instantly generates Dart translation files and a reactive UI controller.

language_excel_localization

A fast, code-generation Flutter localization package that reads an Excel (.xlsx) sheet and instantly generates Dart translation files and a reactive UI controller.

Bridging the gap between translators (who love Excel) and developers (who love code generation).

🚀 Features

• Excel to Dart: Automatically generates separate .dart files for every language in your Excel sheet.
• No Hardcoded Strings: Includes a powerful .tr() extension to translate strings anywhere in your app.
• Reactive Engine: Built-in ValueNotifier controller that instantly updates the whole app UI when the language is changed.

🛠️ Installation

Add the package to your pubspec.yaml:

dependencies:
  language_excel_localization: ^0.0.3

🚀 The Excel File Details (Rules & Format)

For the code generator to work correctly, you must follow these exact rules for your Excel file:

• **File Name: It must be named exactly languages.xlsx.
• **File Location: Place the file directly inside your project's lib/ folder.
• **Row 1 (Languages): The very first row MUST contain your language names in lowercase (e.g., english, spanish, hindi).
• **Column A (Keys): The very first column acts as your translation keys (the base words you will use in your Dart code).

Once your languages.xlsx file is placed inside the lib/ folder, run this exact command in your terminal:

dart run language_excel_localization:generate

When you run the command above, the package reads your Excel sheet and automatically creates a new folder at lib/generated_localization/. Inside, it builds:

• **localization_lookup.dart: The master configuration file containing AppTranslations.
• **Modular Language Files: (e.g., english.dart, spanish.dart) containing pure Dart Maps of your translations.