Primeiros passos

Instalação

Adicione o runtime e o plugin do Vite. Escolha seu gerenciador de pacotes.

$ pnpm add verbaly @verbaly/vite

Gere tudo com um comando

npx verbaly init escreve a config, cria os catálogos de locales/ e detecta seu bundler. Nunca sobrescreve nada. Prefere configurar à mão? Os passos abaixo fazem o mesmo.

npx verbaly init      # config + locales/ + bundler detection

Adicione o plugin

import verbaly from '@verbaly/vite';

export default {
  plugins: [verbaly({ sourceLocale: 'es' })],
};

sourceLocale é o idioma em que você escreve. Todos os outros idiomas vêm de um catálogo JSON em locales/: deixe ali um en.json ou pt.json e o Verbaly os detecta automaticamente.

Escreva texto, não chaves

import { t, setLocale } from 'virtual:verbaly';

const saludo = t`Hola ${name}, tienes ${count} mensajes`;

await setLocale('pt'); // lazy-loads pt chunk

Em dev, o plugin extrai as mensagens ao vivo: seu catálogo fonte se preenche sozinho, os outros idiomas recebem placeholders "", e verbaly.d.ts mantém chaves e params tipados.

Traduza e verifique

npx verbaly extract   # sync catalogs + types
npx verbaly check     # exit 1 if anything is missing