sync_translations 1.0.3

A Dart CLI tool that synchronizes translation files across multiple locales by ensuring all keys are consistent and complete between source and target files.

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

Option	Description
--source	The main translation file (e.g., English)
--targets	One or more translation files to sync with the source
--dry-run	Shows changes without writing them
--overwrite	Overwrites files automatically
--indent	Sets JSON indentation (default: 2)

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