Ir para o conteúdo
v0.86.2mais recente

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.

Integrações
~3 KBruntime
13pacotes
MITlicença
i18n que parece sem config

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.

FuncionalidadeVerbalyVerbalyi18nextLinguiParaglide
Chaves e params type-safeInferidos do seu textoEmbutido, com um arquivo de declaraçãoTexto no código, sem chaves para errarUma 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 chavesNenhuma, extraídasÀ mão, e a CLI sincronizaEtapa extract → compileÀ mão
Conteúdo dinâmico / CMSRota runtime realSimSimMelhor com chaves conhecidas no build
HTML puro (sem framework)Interpretador de DOMCom um plugin de jQuery——
Traduções faltantesFalha o CI, cada build a listaUm comando da CLI, para CIEtapa de CIinlang check, na CI
Traduções quebradasFalha o CI, cada build a listaLint da CLI, aviso por padrãoSó erros de sintaxeinlang check, na CI
Formato de catálogoJSON puroJSONPO, JSON ou CSVFormato inlang, outros por plugin
Agentes de códigoServidor MCP + skillSkill, MCP hospedado (Locize)Skills e plugin—
Maturidade e ecossistemaPré-1.0: a API ainda pode mudarTestado em grande escala, módulos para tudoEstável, PO padrão para tradutoresEstável, com as ferramentas do inlang
VerbalyVerbaly
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
i18next
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
Lingui
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
Paraglide
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.

  1. Instale

    Três pacotes: o runtime, o plugin e o comando.

     pnpm add verbaly @verbaly/vite
     pnpm add -D @verbaly/compiler
  2. Adicione 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' };
  3. Escreva texto, não chaves

    Chaves, tipos e catálogos: gerados.

    src/app.ts
    import { t, setLocale } from 'verbaly/app';
    
    t`Hola ${name}`;      // keys, types & catalogs: generated
    await setLocale('pt'); // lazy-loads its chunk
  4. Deixe 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.

Comece agora

Já tem catálogos? Abra no Studio

Copiado para a área de transferência