Primeros pasos

Instalación

Agrega el runtime, el plugin de Vite y el compilador, que es donde vive el comando verbaly. Elige tu gestor de paquetes.

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

El runtime es siempre el mismo; el segundo depende de tu setup. En webpack, Rollup, esbuild o Rspack instalas @verbaly/unplugin en su lugar, y Next.js, Nuxt y Astro tienen el suyo. Ver Paquetes.

Genera todo con un comando

npx verbaly init escribe la config, crea los catálogos de locales/ y detecta tu bundler, así que te dice qué plugin necesitas y dónde va. Nunca sobrescribe nada. Cablear el plugin te toca a ti, y es el paso siguiente.

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

Agrega el plugin

import verbaly from '@verbaly/vite';

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

sourceLocale es el idioma en el que escribes. Si no listas locales, cada catálogo JSON de locales/ es un idioma: deja ahí un en.json o pt.json y Verbaly los detecta. Si listas locales, esa lista es la lista entera, así que un fichero que te dejaste olvidado se ignora.

Escribe texto, no claves

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

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

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

En dev, el plugin extrae los mensajes en vivo: tu catálogo fuente se llena solo, los demás idiomas reciben placeholders "", y los tipos generados mantienen claves y params tipados.

Traduce y verifica

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