Integraciones: Conecta better-i18n con tu Stack de Desarrollo

Integraciones: Conecta better-i18n con tu Stack de Desarrollo

better-i18n está construido con API-first. Cada funcionalidad es accesible programáticamente, y la plataforma se integra directamente con las herramientas que los desarrolladores usan a diario: GitHub para código, asistentes de IA para productividad, CI/CD para automatización y SDKs de framework para el runtime.

GitHub

Sincronización bidireccional entre tu repositorio y better-i18n:

• Sincronización entrante — Los eventos de Push desencadenan la importación automática de archivos de traducción mediante webhooks
• Sincronización saliente — Las traducciones publicadas se entregan como pull requests a tu repositorio
• Patrones de archivo — Configura qué rutas se sincronizan (p. ej., locales/**/*.json)
• Permisos mínimos — Solo lectura/escritura en archivos de traducción, webhooks para eventos de Push

La integración con GitHub mantiene tu proyecto en la nube y tu repositorio sincronizados sin intervención manual. Mantienes el control total de fusión sobre los PRs de traducción.

Más información sobre la integración con GitHub →

Asistentes de IA (MCP)

Dos servidores MCP conectan las herramientas de IA directamente con tu workspace de traducción:

Herramientas de IA compatibles

Tu asistente de IA puede crear keys, traducir contenido, gestionar glosarios, previsualizar cambios pendientes y publicar — todo mediante lenguaje natural.

Más información sobre la integración MCP →

CLI

El @better-i18n/cli se integra en tu flujo de trabajo de desarrollo:

Scan: Detectar cadenas de texto codificadas

npx @better-i18n/cli scan --ci

Encuentra texto no traducido en código React/Next.js. Compatible con useTranslations(), getTranslations(), texto JSX y atributos.

Sync: Comparar local vs. nube

npx @better-i18n/cli sync --format json

Muestra qué keys existen en el código pero no en la nube (faltantes), y qué keys en la nube no se usan en el código (no utilizadas).

Integración CI/CD

# GitHub Actions
- run: npx @better-i18n/cli scan --ci      # Bloquear PRs con cadenas codificadas
- run: npx @better-i18n/cli sync --format json  # Auditar cobertura de traducción

# Hook pre-commit
npx husky init
echo "npx @better-i18n/cli scan --staged --ci" > .husky/pre-commit

Más información sobre la CLI →

REST API

Acceso programático completo a todas las operaciones de gestión de traducciones:

Base URL: https://dash.better-i18n.com/api Auth: Authorization: Bearer your-api-key

Las API keys se crean en el dashboard, tienen alcance a proyectos específicos y son revocables al instante.

Más información sobre la REST API →

Content SDK

Un query builder de estilo Supabase para obtener contenido localizado:

import { createClient } from "@better-i18n/sdk";

const client = createClient({
  project: "your-org/your-project",
  apiKey: process.env.BETTER_I18N_CONTENT_API_KEY,
});

const { data, total } = await client
  .from("blog-posts")
  .eq("status", "published")
  .language("fr")
  .order("publishedAt", { ascending: false })
  .limit(20);

Sin dependencias, completamente tipado en TypeScript, funciona en cualquier runtime de JavaScript.

Más información sobre el Content SDK →

SDKs de Framework

Todos los SDKs utilizan el mismo endpoint CDN y la misma estructura de namespace. Tus aplicaciones web y móviles comparten una única fuente de verdad para las traducciones.

CDN

Las traducciones se sirven desde la red edge de Cloudflare:

https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json

• Entrega en menos de 100 ms en todo el mundo (300+ ubicaciones edge)
• Las actualizaciones se propagan en segundos tras la publicación
• No se necesita redespliegue de la aplicación para cambios de traducción
• Endpoint de manifiesto para el descubrimiento de idiomas

Más información sobre la entrega CDN →

Integraciones personalizadas

La REST API y el Content SDK permiten integraciones personalizadas con cualquier sistema:

• Herramientas internas — Incorpora la gestión de traducciones en tus paneles de administración
• Flujos de trabajo automatizados — Activa traducciones desde tu pipeline de eventos
• Dashboards personalizados — Lleva métricas de traducción a tus analíticas
• Pipelines de contenido — Integra contenido localizado en tu CMS

Cada operación disponible en el dashboard también está disponible mediante API. Si puedes hacer una solicitud HTTP, puedes integrarte con better-i18n.

Primeros pasos

1. GitHub — Conecta tu repositorio en la configuración del proyecto
2. MCP — Añade npx @better-i18n/mcp a la configuración de tu herramienta de IA
3. CLI — npm install -D @better-i18n/cli
4. API — Genera una API key en dash.better-i18n.com/settings/api-keys

Todas las integraciones están disponibles en todos los planes, incluido el nivel gratuito.