🌍 Localization Comparison Tool

A powerful, modern desktop application for comparing, analyzing, and managing localization files. Built with Flutter for native performance.

🎯 What It Does

The Localization Comparison Tool helps developers, translators, and localization teams efficiently manage their translation workflows. Beyond just comparing files, it offers a complete suite of tools for validating translations, tracking changes, and ensuring quality across your entire project.

✨ Key Features

📊 Intelligent Comparison & Analysis

Stop squinting at JSON files. Our advanced diff engine automatically highlights added, removed, and modified keys.

• Visual Diff: Clear color-coded indicators for all changes.
• Deep Dive: Switch to the Advanced Diff view for a granular, row-by-row analysis of changes.
• Similarity Detection: Smart algorithms detect how much a modified string has changed.

📁 Batch Processing & Directories

Need to compare entire languages? Drag and drop folders to compare multiple files at once.

• Directory Comparison: Compare matching files across two different directories.
• Smart Matching: Automatically pairs files based on structure and naming.

📈 Quality Dashboard

Keep your localization health in check with the integrated Quality Dashboard.

• Analytics: See translation progress, missing keys, and potential issues at a glance.
• Visual Reports: Charts and graphs to visualize your project's localization status.

🕒 History & Session Management

Never lose track of a comparison. The History allows you to revisit past sessions instantly.

• Session Tracking: Every comparison is saved automatically.
• Quick Restore: One-click to reload previous file pairs and settings.

⚙️ Comprehensive Settings

Tailor the tool to your workflow.

• AI Integration: Configure API keys for AI-powered translation suggestions (Gemini, etc.).
• Theming: Choose between Light, Dark, and AMOLED modes with custom accent colors.
• Ignored Patterns: Set up regex rules to ignore specific keys (like metadata or IDs).

🔧 Supported File Formats

The tool supports a wide range of industry-standard formats:

🚀 Installation & Setup

Option 1: Quick Start (Windows)

1. Download the latest release from the Releases Page.
2. Unzip and run the executable.

Option 2: Build from Source

Prerequisites:

• Flutter SDK (3.19+)
• Windows 10/11

# 1. Clone the repository
git clone https://github.com/KhazP/LocalizerAppMain.git
cd LocalizerAppMain

# 2. Install dependencies
flutter pub get

# 3. Generate data models
dart run build_runner build --delete-conflicting-outputs

# 4. Run the app
flutter run -d windows

🤝 Contributing

Contributions are welcome! This project uses:

• Flutter & Dart
• BLoC pattern for state management
• Hive for local persistence
• Material Design 3

Please read our Contributing Guide before getting started.

📜 License

This project is licensed under the Mozilla Public License 2.0. See the LICENSE file for details.