El compilador extrae tus mensajes, genera los tipos y separa los bundles por idioma. Una traducción faltante rompe el build, 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.
Un solo runtime bajo cada adaptador, así que el mensaje que escribes es el mismo en todos. Lo único que cambia es el paquete.
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.00 KB, cero deps | ~14 KB (+9 KB react) | ~5 KB | ~0 (compilado) |
| 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 | El build falla | Warning en runtime | Paso de CI | El build falla |
| Traducciones rotas | El build falla | — | — | — |
| Formato de catálogo | JSON plano | JSON | PO / JSON | Formato inlang |
| Agentes de código | Servidor MCP + skill | — | Skill | — |
VerbalyLos tamaños son huellas gzip aproximadas del runtime; cada proyecto pondera los trade-offs distinto.
Tres 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.
Un comando, dos paquetes.
pnpm add verbaly @verbaly/viteApú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 # the build gate, in your pipelinePronto podrás romperlo tú.
Un playground sobre el runtime real: edita los catálogos, cambia de idioma, vacía una traducción y mira cómo la caza el gate del build. Se está construyendo ahora mismo.
Mientras tanto, lee la guía