Primeiros passos

Instalação

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

$ pnpm add verbaly @verbaly/vite

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 em locales/ e diz qual integração o seu projeto precisa. Ele nunca sobrescreve nada. Prefere ligar na mão? Os passos abaixo fazem o mesmo.

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. 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