🌍 Language Translator App

A beautiful, modern language translation app built with Flutter featuring glassmorphism design, voice input, text-to-speech, and translation history.

✨ Features

🎨 Beautiful UI

• Glassmorphism Design - Stunning frosted glass effects with blur and transparency
• Sage Green Theme - Calming, nature-inspired color palette
• Responsive Layout - Adapts perfectly to mobile, tablet, desktop, and web
• Smooth Animations - Polished transitions and micro-interactions
• Clean Minimal Icons - Professional Material Design icons throughout

🚀 Core Features

• Real-time Translation - Instant translation using Google Translate API
• Auto-Translate Mode - Automatic translation with debouncing (500ms)
• 18+ Languages Supported - English, Spanish, French, German, Hindi, Arabic, Chinese, Japanese, Korean, and more
• Detected Language Display - Shows the detected source language when using Auto mode

🎤 Advanced Features

• Speech-to-Text - Voice input for hands-free translation
• Text-to-Speech - Listen to translations with native pronunciation
• Copy & Paste - Quick clipboard actions for input and output
• Translation History - Persistent storage of up to 50 recent translations
• Favorites System - Mark important translations with hearts
• Character Counter - Real-time character count display
• Swap Languages - Quick language reversal with one tap

📱 Platform Support

• ✅ Android
• ✅ iOS
• ✅ Web
• ✅ Windows
• ✅ macOS
• ✅ Linux

📸 Screenshots

The app features:

• Gradient sage green background (light → medium → mint)
• Frosted glass cards with blur effects
• Side-by-side input/output on wide screens
• Stacked layout on mobile devices
• Expandable history section with gradient avatars
• Color-coded action buttons

🎯 Usage

Basic Translation

1. Select source language (or use Auto-detect)
2. Select target language
3. Type or paste text in the input field
4. Tap "Translate" or wait for auto-translate

Voice Input

1. Tap the microphone button
2. Speak your text
3. Translation happens automatically if auto-translate is enabled

Text-to-Speech

1. After translation appears
2. Tap the speaker icon to hear the pronunciation

History Management

1. All translations are automatically saved
2. Tap any history item to reuse it
3. Tap the heart icon to mark as favorite
4. Tap the copy icon to copy the translation

Keyboard Shortcuts

• Press Enter to translate (when auto-translate is off)
• Copy/Paste with standard shortcuts (Ctrl+C/V or Cmd+C/V)

Key Components

• TranslatorPage: Stateful widget managing translation state
• _GlassCard: Glassmorphism effect with BackdropFilter
• _LanguageDropdown: Custom dropdown for language selection
• Translation Logic: Google Translate API integration
• History Storage: SharedPreferences for persistence
• Speech Integration: speech_to_text & flutter_tts

🎨 Theme Customization

The app uses a sage green color scheme:

Primary Colors:
- Light Sage: #9DC88D
- Medium Sage: #7FB069
- Mint Green: #A8D5BA

Accent Colors:
- Light backgrounds: #E8F5E3, #D4E8D0
- Dark text: #5A7C4A, #4A6B3F
- Clear button: #FFE8E0 / #B85C50

To change the theme, modify the gradient colors in main.dart:

gradient: LinearGradient(
  colors: [Color(0xFF9DC88D), Color(0xFF7FB069), Color(0xFFA8D5BA)],
)

🐛 Known Issues

1. SharedPreferences on Web: May show MissingPluginException on first hot restart. Do a full restart to resolve.
2. Speech-to-Text: Not available on all platforms. The app gracefully handles unavailability.
3. BackdropFilter Performance: May be slower on older devices. Consider reducing blur values if needed.

👨‍💻 Author

@kanizadev

Created with ❤️ using Flutter

🙏 Acknowledgments

• Google Translate API for translation services
• Flutter team for the amazing framework
• Material Design for beautiful icons
• All open-source package contributors

📞 Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Check the Flutter documentation
• Review the package documentation for dependencies

---

Star ⭐ this repository if you find it helpful!