verbatra

mcp
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Open source i18n automation for locale files: translate only what changed, gate CI on drift, watch, review in Studio, keep placeholders intact.

README.md

verbatra logo

verbatra

Automate i18n translation: only what changed gets translated, and nothing that breaks a placeholder gets written.

npm version npm downloads per month License: MIT CI status on main Test coverage OpenSSF Scorecard Required Node.js version Documentation

Description

verbatra keeps your application's locale files translated. You edit the source locale; verbatra sends only new and changed strings to the AI or machine-translation provider you choose, checks every result, and writes the target locales in their own format and key order.

It reads and writes the common i18n file formats (i18next, vue-i18n, next-intl, ngx-translate, XLIFF, YAML, Flutter ARB, gettext, Android, Apple, .NET and more) and works with LLM and machine-translation providers, or with none at all.

Quick start

Needs Node.js ^22.22.0 || >=24. Steps 1 to 3 need no account and no API key.

  1. Install the CLI.

    npm install --save-dev @verbatra/cli
    
  2. Have a source locale file. Skip this step if your project already has one.

    mkdir -p locales && echo '{ "greeting": "Hello, {{name}}!" }' > locales/en.json
    
  3. Scaffold verbatra.config.ts and .env.example, then preview the run without a provider call or a write.

    npx @verbatra/cli init --format i18next-json --provider gemini --yes
    npx @verbatra/cli translate --dry-run
    
  4. Copy .env.example to .env and set GEMINI_API_KEY in it. Then translate, and confirm every locale is in sync (check exits 1 when one is not, so it can gate CI).

    npx @verbatra/cli translate
    npx @verbatra/cli check
    

Gemini has a free tier: create a key in Google AI Studio. The quickstart walks through each step, and Pick your stack has the --format id for your framework.

Why you can trust a run

  • Integrity gate. A translation that drops a placeholder, breaks markup or ICU, or comes back empty is withheld and reported, never written. Translation safety
  • Lock file and provenance. verbatra.lock.json makes every run diff-driven, and verbatra.provenance.json records who or what wrote each value and whether a person reviewed it. The lock file, Provenance evidence
  • Keys from the environment only. Never from the config, a CLI argument, or a function argument, and never printed. Providers
  • Human-only mode. provider: none turns machine translation off by policy, and export/import hand strings to a translator through the same gate. Human-only workflow
  • No telemetry. The only network requests go to the provider you configure. Data handling

Packages

Package What it is Docs
@verbatra/cli The verbatra binary for your terminal and CI CLI reference
@verbatra/sdk The same engine as a programmatic API; the CLI is a thin wrapper over it SDK reference
@verbatra/studio Verbatra Studio, the local dashboard served by verbatra studio Studio
@verbatra/mcp A stdio MCP server that exposes verbatra to coding agents MCP server

Each package has its own README and changelog under packages/. The private core, format-adapters, ai-providers, exchange and extract packages are bundled into @verbatra/sdk and are not published on their own.

GitHub Action and agent skills

Documentation

verbatra.kreitz-webdev.de is the reference for every command, config key, format and provider. Start with the quickstart, then How a run works and the config file. For agents, llms.txt indexes every page.

Questions and issues

Ask questions in GitHub Discussions. The issue tracker is for bug reports and feature requests; a bug report with a minimal reproduction gets fixed fastest.

Contributing

Contributions are welcome. Read CONTRIBUTING.md and the Code of Conduct; pnpm install then pnpm verify reproduces the CI merge gate.

Security

Report a vulnerability privately as described in SECURITY.md, never in a public issue.

License

verbatra is MIT licensed. Third-party fonts, icons and dependencies keep their own licenses; see THIRD_PARTY_NOTICES.md.

Reviews (0)

No results found