better-i18n.com
DocumentaciónCentro de ayudaNovedades

¿Cómo creo mi primer proyecto?

Actualizado el Aug 21, 2026Ali Osman Delişmen

Un proyecto contiene las claves, los idiomas y los ajustes de una aplicación o sitio. Crearlo lleva un minuto; las dos cosas que conviene acertar son el idioma de origen y dónde acaba tu clave.

Crearlo #

  1. Inicia sesión en app.better-i18n.com
  2. New Project
  3. Ponle nombre: ese nombre será el slug del proyecto, así que mantenlo corto
  4. Elige el idioma de origen: aquel en el que está escrito tu código
  5. Añade los idiomas a los que quieras traducir
  6. Create

Crea tu proyecto: escribe un nombre y elige tu idioma de origen

El idioma de origen es la única decisión que hay que pensar. Toda traducción se produce a partir de él y el texto original de cada clave vive ahí. Puedes cambiarlo más adelante en Settings → CDN, pero es el punto de referencia de todo lo demás, así que empieza por el idioma en el que realmente escribes.

Los idiomas de destino son baratos de cambiar: añádelos y quítalos desde la página Languages cuando quieras.

Tu identificador de proyecto #

Cada proyecto se direcciona como org/project — acme/dashboard. Lo escribirás en la configuración del SDK, en la de la CLI y en cualquier llamada a la API.

Crear una clave de API #

Settings → API Keys → Create Key.

Create API Key: dale un nombre a tu clave y pulsa Create Key

Ponle un nombre que reconozcas dentro de seis meses («CI», «local dev») y elige una caducidad: 3 meses, 6 meses, 1 año o nunca. La lista muestra cuánto le queda a cada clave y avisa cuando a alguna le falta menos de un mes — una clave que muere en silencio dentro de la CI es una tarde perdida.

La clave se muestra una sola vez. Cópiala cuando aparezca: no podrás volver a leerla, solo sustituirla.

Qué clave va dónde #

LecturaEscrituraSegura en el navegador
Clave de CDN / entrega✓—✓
Clave de API✓✓No

La clave de CDN solo descarga traducciones publicadas, datos públicos que tus visitantes se bajan de todos modos. La clave de API puede modificar tu proyecto, así que su sitio es una variable de entorno del servidor o los secretos de tu CI: nunca en código de cliente ni en un archivo versionado.

Si una clave secreta acaba en algún sitio público: revócala en la página API Keys y crea otra. La revocación es inmediata.

Apuntar tu aplicación al proyecto #

Bash
# .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=...
TypeScript
// La llamada exacta depende de tu framework: consulta la guía del SDK
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

Qué sigue #