Primeiros passos

Instalação

Adicione o runtime, o plugin do Vite e o compilador, que é onde vive o comando verbaly. Escolha seu gerenciador de pacotes.

$ pnpm add verbaly @verbaly/vite @verbaly/compiler

O runtime é sempre o mesmo; o segundo depende do seu setup. Em webpack, Rollup, esbuild ou Rspack você instala @verbaly/unplugin no lugar, e Next.js, Nuxt e Astro têm o seu. Ver Pacotes.

Gere tudo com um comando

npx verbaly init escreve a config, cria os catálogos de locales/ e detecta o seu bundler, por isso te diz de qual plugin você precisa e onde ligá-lo. Nunca sobrescreve nada. Ligar o plugin é com você, e é o passo seguinte.

npx verbaly init      # config + locales/ + the integration to install

Adicione o plugin

import verbaly from '@verbaly/vite';

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

sourceLocale é o idioma em que você escreve. Se você não listar locales, cada catálogo JSON em locales/ é um idioma: deixe ali um en.json ou pt.json e o Verbaly os detecta. Se listar locales, essa lista é a lista inteira, então um arquivo que ficou esquecido é ignorado.

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 os tipos gerados mantêm chaves e params tipados.

Traduza e verifique

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