Instalación
El paquete core funciona en cualquier proyecto TypeScript, sin importar el framework ni el runtime. Si usas un framework como Next.js, React o Astro, puedes añadir el adaptador correspondiente encima de core.
Core
npm install @better-translate/coreCon eso basta en la mayoría de los casos. Funciona en cualquier entorno TypeScript. Lee la documentación aquí: Guía de Core
Adaptadores
Los adaptadores son extensiones de core que añaden utilidades específicas del framework: enrutamiento con locale, contexto y hooks de React, helpers por petición, etc. No sustituyen a core; lo amplían.
Por eso la mayoría de las guías de implementación se parecen entre paquetes: todas parten del mismo traductor core y añaden una capa fina de ergonomía del framework.
Si prefieres control total, puedes omitir los adaptadores y usar @better-translate/core directamente. Obtendrás el mismo comportamiento de traducción y, en algunos proyectos, la ruta solo con core puede ser la más limpia.
Puedes ver los adaptadores disponibles aquí: Adaptadores
CLI
La CLI es una herramienta de desarrollo opcional que elimina el trabajo manual de gestionar archivos de locale.
Hace dos cosas:
- Extract — escanea tu código en busca de cadenas marcadas con
{ bt: true }, las añade al archivo de locale fuente con claves generadas automáticamente y reescribe las llamadas en su lugar - Generate — lee tu archivo de locale fuente y usa un modelo de IA para producir versiones traducidas para cada otro locale
npm install -D @better-translate/cliPara configuraciones basadas en gateway, basta con @better-translate/cli. Si tu better-translate.config.ts importa un proveedor de modelo directo como Ollama, instala también ese paquete, por ejemplo npm install -D ollama-ai-provider-v2.
Antes de ejecutar npx bt extract o npx bt generate, crea better-translate.config.ts. Después, la CLI funciona con cualquier modelo de proveedor del AI SDK, incluidos modelos locales de Ollama.
Requisitos
- Node.js 18+ o Bun 1.0+
- TypeScript 5.x recomendado