sync_translations #

A simple and powerful Dart command-line tool that helps you synchronize translation files across multiple locales in your Flutter or Dart projects.

This tool ensures that all translation keys are consistent across different language files — it adds missing keys, removes unused ones, and keeps your localization organized and up to date.

🚀 Features #

✅ Compare and synchronize .json, .arb, or .yaml translation files
✅ Detect missing or extra keys between locales
✅ Automatically insert missing keys with default values
✅ Supports nested translation structures
✅ Simple command-line usage
✅ Fast and safe — built with pure Dart

📦 Installation #

dart pub global activate sync_translations

⚙️ Usage #

Run the following command in your project root:

sync_translations

Options #

Example:

sync_translations

🧩 Example #

en.json #

{
  "hello": "Hello",
  "bye": "Goodbye"
}

ar.json (before) #

{
  "hello": "مرحبا"
}

After running: #

sync_translations --source en.json --targets ar.json --overwrite

ar.json (after) #

{
  "hello": "مرحبا",
  "bye": "Goodbye"
}

🧠 Why use this? #

Maintaining multiple translation files by hand is error-prone.
sync_translations keeps them clean, synchronized, and complete — saving hours of manual editing.

🧰 Contributing #

Contributions are welcome!
If you’d like to improve the tool or add a new feature:

1. Fork the repo
2. Create a feature branch (git checkout -b feature/awesome-improvement)
3. Commit your changes
4. Open a Pull Request 🚀

🪪 License #

This project is licensed under the MIT License.

Links #

• Repository: GitHub
• Issues: Report bugs or request features
• Author: Mahmoud Othman