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.