El compilador extrae tus mensajes, genera los tipos y separa los bundles por idioma. Cada build lista una traducción faltante y tu CI la para, así que nunca llega a tus usuarios.
Cuatro cosas que hace el compilador por ti, y cada una está corriendo aquí mismo.
Un plugin de Vite. Sin un init() gigante, sin macros de Babel, sin formatos propietarios. Los catálogos son JSON plano que puedes llevar a donde sea.
Por defecto no escribes ninguna. Ponles nombre cuando quieras leerlas, o decláralas en un módulo cuando son un contrato con algo de fuera de tu app, y Verbaly comprueba cada una contra tu catálogo. El texto no cambia.
El propio texto declara sus params, así que si olvidas uno TypeScript te detiene.
¿Sin framework? El intérprete del DOM hidrata los nodos data-verbaly, re-renderiza al cambiar de idioma y observa los elementos nuevos.
Una mirada honesta frente a las herramientas que usarías en su lugar. Muestra dónde gana Verbaly y dónde las demás también están bien.
| Funcionalidad |  Verbaly | i18next | Lingui | Paraglide |
|---|---|---|---|---|
| Keys y params type-safe | Inferidos de tu texto | Plugin / manual | Parcial | Sí |
| Tamaño del runtime (gzip) | 3,31 KB, cero deps (6,13 con DOM + urls) | 13,6 KB (23 con React) | 2 KB (4 con React) | compilado, sin runtime compartido |
| Mantenimiento de keys | Ninguno, se extraen | A mano | Paso extract → compile | A mano |
| Contenido dinámico / CMS | Ruta runtime real | Sí | Sí | Débil |
| HTML plano (sin framework) | Intérprete de DOM | — | — | — |
| Traducciones faltantes | Falla el CI, cada build la lista | Warning en runtime | Paso de CI | El build falla |
| Traducciones rotas | Falla el CI, cada build la lista | — | — | — |
| Formato de catálogo | JSON plano | JSON | PO / JSON | Formato inlang |
| Agentes de código | Servidor MCP + skill | — | Skill | — |
VerbalyTres pasos y una barrera, o deja que verbaly init lo genere todo con un comando. Sin archivos de keys a mano: el compilador hace la parte aburrida mientras tú sigues escribiendo el copy del producto.
Una orden, tres paquetes: el runtime, el plugin y el comando.
pnpm add verbaly @verbaly/vite @verbaly/compilerApúntalo al idioma en el que escribes.
import verbaly from '@verbaly/vite';
export default { plugins: [verbaly({ sourceLocale: 'es' })] };Claves, tipos y catálogos: generados.
import { t, setLocale } from 'virtual:verbaly';
t`Hola ${name}`; // keys, types & catalogs: generated
await setLocale('pt'); // lazy-loads its chunkSale con 1 mientras algún idioma esté incompleto, así que el texto sin traducir nunca se publica.
- run: npx verbaly check # exits 1 on a missing or broken translationInstala, añade el plugin y escribe texto. Verbaly extrae los mensajes, genera los tipos y carga cada idioma cuando alguien lo pide.
¿Ya tienes catálogos? Ábrelos en Studio