Flutter Easy Localization Manager

A powerful VS Code extension to manage your Flutter easy_localization translations with ease. Track missing keys, empty translations, unused keys, and edit all your translations in a modern, user-friendly interface.

📸 Features Overview

Complete TreeView Panel

Monitor all your translations at a glance with three organized sections: Missing Keys, Empty Translations, and Unused Keys. Each section provides inline action buttons for quick management.

Track Missing Translation Keys

Instantly identify keys that exist in some languages but are missing in others. Keep your translations synchronized across all supported languages.

Find Empty Translations

Quickly spot translation keys with empty values. Click the inline edit button to navigate directly to the JSON file and fill in the missing translation.

Identify Unused Translations

Discover translation keys that are no longer referenced in your Dart code. Clean up your translation files by removing unused keys with automatic parent cleanup.

Modern Translation Editor

Edit all your translations in a beautiful, centralized interface. Features include real-time search, multi-language editing, empty value highlighting, and a fixed header with always-accessible save button.

Code Highlighting

Missing or empty translation keys are highlighted directly in your Dart code, making it easy to spot issues while you develop.

Hover for Translation Details

Hover over any translation key in your Dart code to see all available translations across all languages in a convenient tooltip.

Quick Fix Actions

Use quick fix actions directly in your Dart code to create missing translation keys or navigate to translation files. Speed up your localization workflow. Right-click in your Dart code to quickly add translation keys.

✨ Features

📊 Translation Overview

• TreeView Panel with three sections:
  • 🔴 Missing Keys: Keys that exist in some languages but not in others
  • ⚠️ Empty Translations: Keys with empty values
  • 🗑️ Unused Keys: Keys not referenced in your Dart code

⚡ Quick Actions

• Inline Edit Buttons: Navigate directly to empty translations in JSON files
• Inline Delete Buttons: Remove unused keys with automatic parent cleanup
• Context Menu Integration: Add translation keys from your Dart code

🎨 Modern Translation Editor

• Search & Filter: Find translation keys instantly with real-time search
• Multi-language Editing: Edit all languages side-by-side in a clean table view
• Empty Value Highlighting: Easily spot missing translations
• Fixed Header: Save button and search always accessible (no scrolling needed)
• Auto-refresh: Changes are immediately reflected after saving

🚀 Smart Features

• Nested Key Support: Handles complex nested translation structures (e.g., login.error.invalidEmail)
• Parent Cleanup: Automatically removes empty parent objects after key deletion
• Search Persistence: Your search filter is preserved after saving changes
• Theme Integration: Seamlessly integrates with your VS Code theme

📦 Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Flutter Easy Localization Manager"
4. Click Install

🎯 Usage

Opening the Translation Manager

1. Open a Flutter project that uses easy_localization
2. Look for the Translations icon in the Activity Bar (sidebar)
3. Or use the Command Palette (Ctrl+Shift+P) and search for "Open Translation Editor"

Managing Translations

From the TreeView:

• Click the ✏️ button next to empty translations to navigate to the JSON file
• Click the 🗑️ button next to unused keys to delete them
• Click the ✏️ button in the TreeView header to open the Translation Editor

From the Translation Editor:

• Use the search bar to filter translation keys
• Edit values directly in the table
• Click "💾 Save Changes" to save all modifications
• Empty values are highlighted in yellow

From Dart Code:

• Right-click in a Dart file
• Select "Add Translation Key" to create a new translation

⚙️ Requirements

• VS Code 1.105.0 or higher
• A Flutter project using easy_localization
• Translation files in assets/translations/*.json format

📝 Translation File Structure

This extension works with the standard easy_localization JSON format:

{
  "welcome": "Welcome",
  "login": {
    "title": "Login",
    "error": {
      "invalidEmail": "Invalid email address"
    }
  }
}

🐛 Known Issues

• None at the moment! Report issues on GitHub

📋 Release Notes

1.0.0

Initial release with:

• TreeView for missing, empty, and unused translations
• Inline edit and delete buttons
• Modern translation editor with search
• Fixed header layout
• Search persistence after save
• Automatic parent cleanup after deletion

📄 License

This extension is licensed under the MIT License.

💬 Support

If you find this extension helpful, please consider:

• ⭐ Starring the GitHub repository
• 📝 Writing a review on the VS Code Marketplace
• 🐛 Reporting bugs or requesting features on GitHub Issues