auto_translate_text_widget

Translate Flutter Text, AutoSizeText, RichText and Animated Text instantly with live language switching, caching, and Google Translator support.

A complete translation UI toolkit for Flutter. Translate any text widget at runtime without restart, without navigation refresh — just call LanguageService.setLanguage() and every translated widget updates instantly.

---

✨ Features

• ✅ Live language switching — no restart required
• ✅ Global LanguageService — ValueNotifier-based reactive updates
• ✅ In-memory translation cache — faster UI, fewer API calls
• ✅ Google Translator integration — powered by the translator package
• ✅ Text widget — AutoTranslateText
• ✅ AutoSizeText — AutoTranslateAutoSizeText
• ✅ Typewriter animation — AutoTranslateTypewriterText
• ✅ RichText — AutoTranslateRichText with per-span translation
• ✅ Shimmer loading — optional shimmer placeholders
• ✅ SharedPreferences persistence — remembers user language
• ✅ Null-safe — fully null-safe Dart
• ✅ Cross-platform — Android, iOS, Web, macOS, Windows, Linux

---

📦 Installation

Add to your pubspec.yaml:

dependencies:
  auto_translate_text_widget: ^1.0.0

Then run:

flutter pub get

---

🚀 Quick Start

Initialize

import 'package:auto_translate_text_widget/auto_translate_text_widget.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await LanguageService.init();
  runApp(MyApp());
}

Basic Text

AutoTranslateText(
  'Welcome to our application',
  style: TextStyle(fontSize: 18),
)

AutoSizeText

AutoTranslateAutoSizeText(
  'This is a very long text',
  maxLines: 2,
)

Typewriter Animation

AutoTranslateTypewriterText(
  'Welcome to Flutter',
  speed: Duration(milliseconds: 60),
)

RichText

AutoTranslateRichText(
  spans: [
    TranslateSpan(
      text: 'Hello ',
      style: TextStyle(fontWeight: FontWeight.bold),
    ),
    TranslateSpan(
      text: 'World',
      style: TextStyle(color: Colors.blue),
    ),
  ],
)

Switch Language

// All translation widgets update automatically!
await LanguageService.setLanguage('bn');

Shimmer Loading

AutoTranslateText(
  'Hello',
  enableShimmer: true,
)

---

🏗 Architecture

LanguageService (ValueNotifier)
        │
        ▼
AutoTranslate (Translation Helper)
        │
        ▼
TranslationCache (In-Memory)
        │
        ▼
GoogleTranslator (API)
        │
        ▼
Translated Widgets

---

📖 API Reference

LanguageService

Method	Description
LanguageService.init()	Initialize and load persisted language
LanguageService.setLanguage(String code)	Set language and persist
LanguageService.getCurrentLanguage()	Get current language code
LanguageService.language	ValueNotifier for reactive updates

AutoTranslate

Method	Description
AutoTranslate.translateText(String text, {String? to})	Translate text, returns String
AutoTranslate.translate(String text, {String? to})	Translate text, returns TranslationModel

TranslationCache

Method	Description
TranslationCache.get(lang, text)	Get cached translation
TranslationCache.set(lang, text, translation)	Cache a translation
TranslationCache.clear()	Clear all cache
TranslationCache.clearForLanguage(lang)	Clear cache for one language

---

🌍 Supported Platforms

Platform	Supported
Android	✅
iOS	✅
Web	✅
macOS	✅
Windows	✅
Linux	✅

---

📄 License

MIT License. See LICENSE for details.

---

Author

Developed with ❤️ by Md Jubayer Hossain
GitHub Profile | Portfolio