🌍 Zeba Academy Multilanguage Toolkit #

A powerful Flutter multilingual utilities toolkit that simplifies internationalization (i18n) with script detection, automatic RTL/LTR switching, translation-ready architecture, and locale management helpers.

Built for scalable Flutter applications requiring clean and flexible language support.

✨ Features #

✅ Script Detection (Tamil, Arabic, Latin, etc.) ✅ Automatic RTL / LTR Direction Switching ✅ Translation-Ready Architecture ✅ Locale Management Helpers ✅ Developer-Friendly Extensions API ✅ Lightweight & Dependency-Free ✅ Easy Integration with Existing Apps

📦 Installation #

Add dependency in your pubspec.yaml:

dependencies:
  zeba_academy_multilanguage_toolkit: ^1.0.0

Then run:

flutter pub get

🚀 Quick Start #

Import the package:

import 'package:zeba_academy_multilanguage_toolkit/zeba_academy_multilanguage_toolkit.dart';

🔎 Script Detection #

Automatically detect language script from text.

final script = ScriptDetector.detectScript('வணக்கம்');

print(script); // tamil

Supported detection:

• Tamil
• Arabic
• Latin
• Unknown fallback

↔️ RTL / LTR Auto Direction #

Automatically set UI direction based on locale.

TextDirection direction =
    DirectionHelper.getDirection(const Locale('ar'));

Result:

• Arabic → RTL
• English → LTR
• Tamil → LTR

🌍 Locale Manager #

Manage app language dynamically.

final localeManager = LocaleManager();

localeManager.changeLanguage('ta');

Use with MaterialApp:

MaterialApp(
  locale: localeManager.locale,
)

🌐 Translation System #

1️⃣ Define Translations #

final controller = TranslationController();

controller.load(
  TranslationModel({
    'en': {'hello': 'Hello'},
    'ta': {'hello': 'வணக்கம்'},
    'ar': {'hello': 'مرحبا'},
  }),
);

2️⃣ Change Language #

controller.changeLanguage('ta');

3️⃣ Translate Text #

Text(controller.tr('hello'));

✨ Context Extensions #

Cleaner developer experience:

context.isRTL
context.textDirection
context.locale

🧱 Auto Direction Wrapper #

Wrap widgets for automatic layout direction.

AutoDirection(
  locale: const Locale('ar'),
  child: MyApp(),
);

📁 Package Structure #

lib/
 └── src/
      ├── core/
      │     ├── script_detector.dart
      │     └── direction_helper.dart
      ├── locale/
      │     ├── locale_manager.dart
      │     └── locale_extensions.dart
      ├── translation/
      │     ├── translation_controller.dart
      │     └── translation_model.dart
      └── utils/
            └── language_constants.dart

🧪 Testing #

Run tests:

flutter test

🎯 Use Cases #

• Multilingual Apps
• Education Platforms
• International Products
• Arabic / RTL Apps
• Tamil + English Hybrid Apps
• Enterprise Flutter Applications

🛣️ Roadmap #

• ❌ JSON translation loader
• ❌ ARB / Flutter Intl support
• ❌ Device locale auto-detection
• ❌ Pluralization support
• ❌ ICU message formatting
• ❌ GetX integration

🤝 Contributing #

Contributions, issues, and feature requests are welcome!

📄 License #

This project is licensed under the GPL License.

👨‍💻 Author #

Zeba Academy

Building reusable Flutter tools for modern app development.

⭐ Support #

If you like this package:

⭐ Star the repository 👍 Share with Flutter developers 🚀 Use it in your projects