Documentação
Configure o verbatra e mantenha cada locale em sincronia.
Guias e referência da CLI, do SDK, do Studio e do servidor MCP: comece pelo início rápido ou peça ao seu agente de programação que configure o verbatra.
Comece pelo seu objetivo
Escolha o que você quer fazer; cada card abre a página que explica como.
Escolha sua stack
Um card marcado com Início rápido abre um guia passo a passo para essa stack; os demais cards abrem o comando init e a estrutura de arquivos.
Cada execução é um diff, não uma reescrita.
O que acontece quando você executa verbatra translate.
Manter manualmente um único locale de origem faz todos os outros arquivos de locale divergirem: chaves novas faltam nos destinos, strings editadas deixam traduções obsoletas para trás e chaves excluídas ficam como órfãs. O verbatra fecha essa lacuna comparando cada destino com um arquivo de lock versionado, verbatra.lock.json, e enviando só o que mudou ao provedor que você configurou; uma segunda execução sem nada novo para traduzir não faz nenhuma chamada ao provedor. Cada resultado é verificado antes de ser gravado, então um placeholder quebrado fica retido e é tentado de novo, nunca publicado. Veja Como funciona uma execução para a sequência completa de etapas.
1. Verificar
verbatra checkcompara a origem, os destinos e o arquivo de lock. Não chama nenhum provedor e dispensa chave de API.2. Traduzir
verbatra translateenvia só as chaves ausentes e alteradas, e recusa qualquer resultado com placeholders incompatíveis, marcação inline quebrada ou sintaxe ICU inválida.3. Barrar na CI
A GitHub Action executa o
checkem cada pull request e o faz falhar enquanto um locale estiver fora de sincronia.
O verbatra lê e grava os formatos comuns de arquivo de locale, de JSON e YAML a XLIFF, gettext e catálogos do Android e da Apple, e traduz por qualquer provedor de LLM ou de tradução automática aceito, por trás de uma única interface (ou por nenhum, em um fluxo somente humano: veja Trabalhar sem tradução automática). Um formato que ele não traz pode ser adicionado como adaptador personalizado (veja Escrever um adaptador de formato personalizado). As listas completas estão em Formatos e Provedores.
Os pacotes
Um motor, quatro formas de operá-lo.
O binário verbatra: todos os comandos, de init e extract a translate, check, export e studio, como uma camada fina sobre o SDK. Comece por aqui.
O motor por baixo: translate, watch, check, diff, doctor, extract, pseudolocalização, geração de tipos e os ciclos de ida e volta com Excel e TMX, tudo a partir do código.
Um painel local com edição direta, uma fila de revisão, uma página Overview de cobertura e execuções e ferramentas para agentes de navegador. O gasto com provedores fica desativado até você ativá-lo.
Um servidor MCP via stdio que expõe o status das traduções, o glossário e ferramentas de edição ao Claude Code, ao Cursor ou a qualquer cliente MCP.