Primeros pasos

Instalación

Agrega el runtime y el plugin de Vite. Elige tu gestor de paquetes.

$ pnpm add verbaly @verbaly/vite

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 en locales/ y te dice qué integración necesita tu proyecto. Nunca sobrescribe nada. ¿Prefieres cablearlo a mano? Los pasos de abajo hacen lo mismo.

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. Los demás idiomas salen de un catálogo JSON en locales/: deja ahí un en.json o pt.json y Verbaly los detecta automáticamente.

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 verbaly.d.ts mantiene claves y params tipados.

Traduce y verifica

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