l10n_vision_cli 1.0.0

The official CLI for L10n Vision. A lightning-fast, offline tool to verify your Flutter ARB translations in CI/CD pipelines and catch missing keys before production.

l10n_vision_cli

💡 Tired of missing translations breaking your builds?

The CLI works best when paired with the L10n Vision Desktop App. Visually sync your Figma designs directly to your Flutter code in seconds, and let the CLI handle the CI/CD checks.

👉 Download L10n Vision for macOS/Windows

The official CLI tool for L10n Vision. Designed to run entirely offline in your CI/CD pipeline to ensure your app's localization files are always in perfect sync before a release.

Why it exists

When you sync Figma keys into app_en.arb via the L10n Vision Desktop App, your app_en.arb becomes the source of truth. However, your other translated ARB files (like app_es.arb or app_fr.arb) might be missing these new keys, leading to Missing translation errors at runtime.

This CLI solves that by running a lightning-fast verification check.

Usage

Run the CLI from the root of your Flutter project:

dart run l10n_vision_cli --dir .

You can optionally specify the source of truth ARB file (defaults to app_en.arb):

dart run l10n_vision_cli --source-of-truth app_en.arb

Example Output

When translations are missing:

Analyzing base translations from app_en.arb...
Found 154 keys in base ARB.

❌ [app_es.arb] fails verification.
   Missing keys (1):
     - login_button_title

L10n Vision CLI: Verification FAILED.

When translations match:

Analyzing base translations from app_en.arb...
Found 154 keys in base ARB.
✅ [app_es.arb] matches exactly.
✅ [app_fr.arb] matches exactly.

L10n Vision CLI: All translations are perfectly synced. Verification PASSED.