🌍 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

---