verbatra
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Open source i18n automation for locale files: translate only what changed, gate CI on drift, watch, review in Studio, keep placeholders intact.
verbatra
Automate i18n translation: only what changed gets translated, and nothing that breaks a placeholder gets written.
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.
Install the CLI.
npm install --save-dev @verbatra/cliHave a source locale file. Skip this step if your project already has one.
mkdir -p locales && echo '{ "greeting": "Hello, {{name}}!" }' > locales/en.jsonScaffold
verbatra.config.tsand.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-runCopy
.env.exampleto.envand setGEMINI_API_KEYin it. Then translate, and confirm every locale is in sync (checkexits1when 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.jsonmakes every run diff-driven, andverbatra.provenance.jsonrecords 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: noneturns machine translation off by policy, andexport/importhand 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
- verbatra/action runs
translate,checkordiffin a workflow withuses: verbatra/action@v1. See GitHub Action. - verbatra/skills teaches coding agents to drive the CLI, the MCP server and Studio. See Connect an MCP client and Set up with an AI agent.
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.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi
