Instalación

El paquete core funciona en cualquier proyecto TypeScript, sin importar el framework o el entorno de ejecución. Si utilizas un framework como Next.js, React o Astro, puedes añadir el adaptador correspondiente sobre core.

Core

npm install @better-translate/core

Eso es todo lo que necesitas en la mayoría de los casos. Funciona en Next.js, Astro, React, Bun, Node.js, scripts, APIs o cualquier entorno TypeScript.

Adaptadores

Los adaptadores son extensiones de core que añaden ayudantes específicos del framework: enrutamiento consciente de la configuración regional, contexto y hooks de React, ayudantes por petición, etc. No reemplazan core, lo extienden.

Puedes consultar los adaptadores disponibles aquí:

CLI

La CLI es una herramienta de desarrollo opcional que elimina el trabajo manual de gestionar los archivos de configuración regional.

Hace dos cosas:

• Extract — escanea tu código en busca de cadenas marcadas con { bt: true }, las añade a tu archivo de configuración regional fuente con claves generadas automáticamente y reescribe las llamadas en su lugar
• Generate — lee tu archivo de configuración regional fuente y utiliza un modelo de IA para producir versiones traducidas para cada otra configuración regional

npm install -D @better-translate/cli

Para configuraciones basadas en gateway, @better-translate/cli es suficiente. 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 de eso, la CLI funciona con cualquier modelo de proveedor de AI SDK, incluyendo modelos locales de Ollama.

Requisitos

• Node.js 18+ o Bun 1.0+
• TypeScript 5.x recomendado

Siguiente paso