O compilador extrai suas mensagens, gera os tipos e separa os bundles por idioma. Uma tradução faltando quebra o build, então ela nunca chega aos seus usuários.
Quatro coisas que o compilador faz por você, e cada uma está rodando aqui mesmo.
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.
Um único runtime sob cada adaptador, então a mensagem que você escreve é a mesma em todos. Só muda o pacote.
O próprio texto declara seus params, então se você esquecer um o TypeScript te barra.
Sem framework? O interpretador do DOM hidrata os nós data-verbaly, re-renderiza ao trocar o idioma e observa novos elementos.
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 |  Verbaly | i18next | Lingui | Paraglide |
|---|---|---|---|---|
| Keys e params type-safe | Inferidos do seu texto | Plugin / manual | Parcial | Sim |
| Tamanho do runtime (gzip) | 3.00 KB, zero deps | ~14 KB (+9 KB react) | ~5 KB | ~0 (compilado) |
| Manutenção de keys | Nenhuma, extraídas | À mão | Etapa extract → compile | À mão |
| Conteúdo dinâmico / CMS | Rota runtime real | Sim | Sim | Fraco |
| HTML puro (sem framework) | Interpretador de DOM | — | — | — |
| Traduções faltantes | O build falha | Warning em runtime | Etapa de CI | O build falha |
| Traduções quebradas | O build falha | — | — | — |
| Formato de catálogo | JSON puro | JSON | PO / JSON | Formato inlang |
| Agentes de código | Servidor MCP + skill | — | Skill | — |
VerbalyOs tamanhos são pegadas gzip aproximadas do runtime; cada projeto pondera os trade-offs de forma diferente.
Três passos e uma barreira, ou deixe o verbaly init gerar tudo com um comando. Sem arquivos de keys à mão: o compilador faz a parte chata enquanto você continua escrevendo o copy do produto.
Um comando, dois pacotes.
pnpm add verbaly @verbaly/viteAponte para o idioma em que você escreve.
import verbaly from '@verbaly/vite';
export default { plugins: [verbaly({ sourceLocale: 'es' })] };Chaves, tipos e catálogos: gerados.
import { t, setLocale } from 'virtual:verbaly';
t`Hola ${name}`; // keys, types & catalogs: generated
await setLocale('pt'); // lazy-loads its chunkSai com 1 enquanto algum idioma estiver incompleto, então texto sem tradução nunca é publicado.
- run: npx verbaly check # the build gate, in your pipelineEm breve você poderá quebrá-lo você mesmo.
Um playground sobre o runtime real: edite os catálogos, troque de idioma, esvazie uma tradução e veja o gate do build pegar o erro. Está sendo construído agora mesmo.
Enquanto isso, leia o guia