i18n-linter-rb

A linter for YAML i18n locale files, built for Ruby and Rails projects.

It detects translation keys that exist in your source locale but are missing from other locales, so you never ship an app with incomplete translations.

• Works out of the box with the Rails convention (config/locales/)
• Compares nested keys using dot notation (e.g. users.edit.title)
• Supports multiple target locales in a single run
• Optional configuration file for project-specific defaults
• Exit code 1 when keys are missing, ready for CI pipelines

gem install i18n-linter-rb

Or add it to your Gemfile:

gem "i18n-linter-rb"

Run it from your project root. By default it looks for config/locales/, compares en.yml against es.yml, and reports missing keys:

i18n-linter-rb

Example output:

Missing keys in es.yml:
  - users.new.title
  - errors.not_found

If no locales directory is found, a usage guide is printed to help you configure the tool.

Usage: i18n-linter-rb [options]
    -p, --path PATH                  Locales directory (default: config/locales)
    -f, --from LOCALE                Source locale (default: en)
    -t, --to LOCALES x,y,z           Target locales (default: es)
    -i, --init                       Create a default .i18n_linter.yml in the current directory
    -v, --version                    Show version
    -h, --help                       Show this help

Examples:

# Custom locales directory
i18n-linter-rb --path translations/locales

# Compare English against several languages
i18n-linter-rb --from en --to es,fr,pt

If you pass --path manually and no .i18n_linter.yml exists yet, the CLI prints a tip suggesting you persist it with --init instead.

Create an .i18n_linter.yml file in your project root to persist your settings. Run i18n-linter-rb --init to generate one with the default values, or create it by hand:

locales_path: config/locales
source_locale: en
target_locales:
  - es
  - fr
  - pt

Precedence order: CLI flags > configuration file > defaults.

After checking out the repo, run the test suite with:

rake spec

To try the CLI locally without installing the gem:

ruby -Ilib exe/i18n-linter-rb --help

Bug reports and pull requests are welcome on GitHub at https://github.com/MarceloM47/i18n-linter-rb. See CONTRIBUTING.md for setup and guidelines.

The gem is available as open source under the terms of the MIT License.