¿Cómo creo mi primer proyecto?

Un proyecto es el contenedor de todas tus traducciones. Cada aplicación o sitio web tiene su propio proyecto.

Paso 1: Regístrate o inicia sesión

Ve a app.better-i18n.com e inicia sesión con tu cuenta. Si no tienes una, puedes registrarte de forma gratuita.

Paso 2: Crea un nuevo proyecto

1. Haz clic en "Nuevo proyecto" desde el panel
2. Ingresa un nombre de proyecto (ej. "Mi sitio web")
3. Elige tu idioma fuente — este es el idioma en el que escribes tu código (generalmente inglés)
4. Añade tus idiomas de destino — los idiomas a los que quieres traducir
5. Haz clic en Crear

Paso 3: Anota el identificador de tu proyecto

Cada proyecto tiene un identificador único en formato org/project, como acme/dashboard. Lo encontrarás en la configuración de tu proyecto. Lo necesitarás para:

• Configuración del SDK (project: "acme/dashboard")
• Configuración del CLI (better-i18n.config.ts)
• Llamadas a la API

Paso 4: Obtén tu clave API

Ve a Configuración → Claves API y crea una nueva clave. Necesitarás dos tipos:

Tipo de clave	Propósito	Dónde usarla
Clave pública	Solo lectura, acceso CDN	SDK de frontend, código del lado del cliente
Clave secreta	Acceso completo	CLI, CI/CD, lado del servidor

Consejo de seguridad: Nunca expongas tu clave secreta en código del lado del cliente. Las claves públicas son seguras para los navegadores.

Paso 5: Configura tu SDK

Agrega el ID de tu proyecto y la clave pública a tu SDK de framework:

// Ejemplo: Next.js
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

# Ejemplo: archivo .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=pk_...

¿Qué sigue?

• Agrega tus primeras claves de traducción
• Configura el CLI
• Publica las traducciones