Find Unused Translations in Flutter Projects

This package is used to find unused keys inside your easy_localization files. Managing translations in Flutter projects can become messy over time. Unused keys accumulate, cluttering your translation files and making maintenance a headache. This package helps you effortlessly identify and remove unused translation keys specifically in projects using the easy_localization package, keeping your project clean and efficient.

Features

• Effortlessly identify and remove unused translation keys, reducing clutter and improving project maintainability.
• Ensure consistency across all your translation files by detecting missing keys.

Installation

Add this to your pubspec.yaml file as a dev dependency:

dev_dependencies:
  intl_usage: ^1.2.0

Make sure you also have easy_localization installed in your project:

dependencies:
  easy_localization: ^latest_version

  flutter pub get

Usage

Find Unused Keys:

  dart run intl_usage:find_usages

This command scans your project and prints a list of unused translation keys, as well as keys whose usage is uncertain (e.g., due to dynamic string concatenation).

** Find Missing Keys:**

  dart run intl_usage:check_translations

This command checks your translation files for consistency and reports any keys that are missing in one or more files.

Customization Options:

• --path: Specifies the path to your translation files. If not provided, the package defaults to searching in assets/translations. You can also define this path in a YAML configuration file (see below).
• --known_used_keys: Specifies the translations keys you are sure of being used. Either because these are used in a separate package, created dynamically or defined in a separate json file that the system loads at runtime.

Using a YAML Configuration File:

You can create a intl_usage.yaml file in the root of your project to define the translation path:

  path: your/translation/path
  known_used_keys:
    - key1
    - key2
    - ...

This eliminates the need to specify the --path or the --known_used_keys option every time you run the commands.

Limitations

Currently, this package only supports translations generated with the easy_localization package.Support for other translation solutions may be added in future releases.

License

This project is licensed under the MIT License.