remove_unused_localizations_keys #

A Dart CLI tool that automatically detects and removes unused localization keys from .arb files, keeping your project clean and optimized.

Features #

✅ Scans all .arb files dynamically (supports multiple languages).
✅ Detects and removes only truly unused keys (avoiding false deletions).
✅ Works with global localization variables like:

localizations.welcome
S.of(context).welcome
AppLocalizations.of(context)!.welcome
_appLocalizations.key
cubit.appLocalizations.key
SomeClass.someVariable.appLocalizations.key
Localizations.of(context) Access
Localizations.of(context)!.key
Localizations.of(context)?.key
Localizations.of(AppNavigation.context)!.key
Localizations.of(this.context)!.key
Localizations.of(BuildContext ctx)!.key

✅ Excludes important files (e.g., app_localizations.dart).
✅ Provides a detailed report of removed keys.

Installation #

Add the package to your dev dependencies in pubspec.yaml:

dev_dependencies:
  remove_unused_localizations_keys: ^0.0.2

Run:

flutter pub get

Usage #

Run the Package from the Terminal #

You can run the package directly as a CLI tool using:

dart run remove_unused_localizations_keys

This will automatically scan all .arb files in your project, detect unused keys, and remove them, keeping your localization files clean and optimized.

If you want to keep the unused keys in order to delete it manually you can use this command:

dart run remove_unused_localizations_keys --keep-unused

Example Output #

Unused keys found: welcome_message, login_button
Updated lib/l10n/app_en.arb, removed unused keys.
Updated lib/l10n/app_ar.arb, removed unused keys.
✅ Unused keys successfully removed.

Contributing #

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License #

This project is licensed under the MIT License. See LICENSE for details.