- Chaves e params type-safe
- Inferidos do seu texto
- Tamanho do runtime (gzip)
- 3,35 KB, zero deps (6,17 com DOM + urls)
- Manutenção de chaves
- Nenhuma, extraídas
- Conteúdo dinâmico / CMS
- Rota runtime real
- HTML puro (sem framework)
- Interpretador de DOM
- Traduções faltantes
- Falha o CI, cada build a lista
- Traduções quebradas
- Falha o CI, cada build a lista
- Formato de catálogo
- JSON puro
- Agentes de código
- Servidor MCP + skill
- Maturidade e ecossistema
- Pré-1.0: a API ainda pode mudar
Escreva texto natural. Publique traduções type-safe.
O compilador extrai suas mensagens, gera os tipos e separa os bundles por idioma. Cada build lista uma tradução faltando e o seu CI a barra, então ela nunca chega aos seus usuários.
Por que Verbaly
Quatro coisas que o compilador faz por você, e cada uma está rodando aqui mesmo.
Zero config, de verdade
Um plugin do Vite. Sem um init() gigante, sem macros do Babel, sem formatos proprietários. Os catálogos são JSON puro que você leva para qualquer lugar.
As chaves são suas
Por padrão você não escreve nenhuma. Dê nome a elas quando quiser lê-las, ou declare-as em um módulo quando forem um contrato com algo fora do seu app, e o Verbaly verifica cada uma contra o seu catálogo. O texto não muda.
Tipos das suas mensagens
O próprio texto declara seus params, então se você esquecer um o TypeScript te barra.
HTML puro, de primeira
Sem framework? O Verbaly preenche cada elemento data-verbaly, atualiza ao trocar de idioma e detecta os novos.
Seu agente traduz. Você decide.
Conecte o servidor MCP e seu agente extrai as mensagens, traduz as que faltam e confere que nada quebre. O que ele escreve fica marcado como da máquina até você marcar como lido no Studio.
Funciona com seu agente
- Claude Code
- Codex
- Cursor
- GitHub Copilot
- Gemini CLI
- Windsurf
- Zed
- Cline
E com qualquer cliente MCP. Como conectar
O mesmo trabalho, menos maquinaria
Um olhar honesto frente às ferramentas que você usaria no lugar. Mostra onde o Verbaly ganha e onde as outras também funcionam bem.
| Funcionalidade | i18next | Lingui | Paraglide | |
|---|---|---|---|---|
| Chaves e params type-safe | Inferidos do seu texto | Embutido, com um arquivo de declaração | Texto no código, sem chaves para errar | Uma função tipada por mensagem |
| Tamanho do runtime (gzip) | 3,35 KB, zero deps (6,17 com DOM + urls) | 15,5 KB (22,1 com React) | 2,3 KB (4,4 com React) | compilado, sem runtime compartilhado |
| Manutenção de chaves | Nenhuma, extraídas | À mão, e a CLI sincroniza | Etapa extract → compile | À mão |
| Conteúdo dinâmico / CMS | Rota runtime real | Sim | Sim | Melhor com chaves conhecidas no build |
| HTML puro (sem framework) | Interpretador de DOM | Com um plugin de jQuery | — | — |
| Traduções faltantes | Falha o CI, cada build a lista | Um comando da CLI, para CI | Etapa de CI | inlang check, na CI |
| Traduções quebradas | Falha o CI, cada build a lista | Lint da CLI, aviso por padrão | Só erros de sintaxe | inlang check, na CI |
| Formato de catálogo | JSON puro | JSON | PO, JSON ou CSV | Formato inlang, outros por plugin |
| Agentes de código | Servidor MCP + skill | Skill, MCP hospedado (Locize) | Skills e plugin | — |
| Maturidade e ecossistema | Pré-1.0: a API ainda pode mudar | Testado em grande escala, módulos para tudo | Estável, PO padrão para tradutores | Estável, com as ferramentas do inlang |
- Chaves e params type-safe
- Embutido, com um arquivo de declaração
- Tamanho do runtime (gzip)
- 15,5 KB (22,1 com React)
- Manutenção de chaves
- À mão, e a CLI sincroniza
- Conteúdo dinâmico / CMS
- Sim
- HTML puro (sem framework)
- Com um plugin de jQuery
- Traduções faltantes
- Um comando da CLI, para CI
- Traduções quebradas
- Lint da CLI, aviso por padrão
- Formato de catálogo
- JSON
- Agentes de código
- Skill, MCP hospedado (Locize)
- Maturidade e ecossistema
- Testado em grande escala, módulos para tudo
- Chaves e params type-safe
- Texto no código, sem chaves para errar
- Tamanho do runtime (gzip)
- 2,3 KB (4,4 com React)
- Manutenção de chaves
- Etapa extract → compile
- Conteúdo dinâmico / CMS
- Sim
- HTML puro (sem framework)
- —
- Traduções faltantes
- Etapa de CI
- Traduções quebradas
- Só erros de sintaxe
- Formato de catálogo
- PO, JSON ou CSV
- Agentes de código
- Skills e plugin
- Maturidade e ecossistema
- Estável, PO padrão para tradutores
- Chaves e params type-safe
- Uma função tipada por mensagem
- Tamanho do runtime (gzip)
- compilado, sem runtime compartilhado
- Manutenção de chaves
- À mão
- Conteúdo dinâmico / CMS
- Melhor com chaves conhecidas no build
- HTML puro (sem framework)
- —
- Traduções faltantes
- inlang check, na CI
- Traduções quebradas
- inlang check, na CI
- Formato de catálogo
- Formato inlang, outros por plugin
- Agentes de código
- —
- Maturidade e ecossistema
- Estável, com as ferramentas do inlang
Conferido com a documentação de cada ferramenta em novembro de 2026 (i18next 27, Lingui 6, Paraglide 3). Os tamanhos são min + gzip do que um app importa, sem contar o React.
De palavras a idiomas publicados
Três passos e uma barreira, e o verbaly init escreve a sua config para você. Sem arquivos de chaves à mão: o compilador faz a parte chata enquanto você continua escrevendo o copy do produto.
Instale
Três pacotes: o runtime, o plugin e o comando.
pnpm add verbaly @verbaly/vitepnpm add -D @verbaly/compilerAdicione o plugin
Aponte para o idioma em que você escreve.
vite.config.ts · verbaly.config.ts// vite.config.ts import verbaly from '@verbaly/vite'; export default { plugins: [verbaly()] }; // verbaly.config.ts export default { sourceLocale: 'es' };Escreva texto, não chaves
Chaves, tipos e catálogos: gerados.
src/app.tsimport { t, setLocale } from 'verbaly/app'; t`Hola ${name}`; // keys, types & catalogs: generated await setLocale('pt'); // lazy-loads its chunkDeixe o CI vigiar
Sai com 1 enquanto algum idioma estiver incompleto, então texto sem tradução nunca é publicado.
.github/workflows/ci.yml- run: npx verbaly check # exits 1 on a missing or broken translation
Sua primeira página traduzida, em cinco minutos.
Instale, adicione o plugin e escreva o texto. O Verbaly extrai as mensagens, gera os tipos e carrega cada idioma quando alguém pede.
Já tem catálogos? Abra no Studio