Integrationen: better-i18n mit deinem Entwicklungs-Stack verbinden

Integrationen: better-i18n mit deinem Entwicklungs-Stack verbinden

better-i18n ist API-first entwickelt. Jede Funktion ist programmatisch zugänglich, und die Plattform integriert sich direkt in die Tools, die Entwickler täglich nutzen: GitHub für Code, KI-Assistenten für Produktivität, CI/CD für Automatisierung und Framework-SDKs für die Laufzeit.

GitHub

Bidirektionale Synchronisation zwischen deinem Repository und better-i18n:

• Eingehende Synchronisation — Push-Events lösen automatischen Import von Übersetzungsdateien per Webhooks aus
• Ausgehende Synchronisation — Veröffentlichte Übersetzungen werden als Pull Requests an dein Repository geliefert
• Dateimuster — Konfiguriere, welche Pfade synchronisiert werden (z. B. locales/**/*.json)
• Minimale Berechtigungen — Nur Lese-/Schreibzugriff auf Übersetzungsdateien, Webhooks für Push-Events

Die GitHub-Integration hält dein Cloud-Projekt und Repository ohne manuelle Eingriffe synchron. Du behältst die volle Merge-Kontrolle über Übersetzungs-PRs.

Mehr über GitHub-Integration →

KI-Assistenten (MCP)

Zwei MCP-Server verbinden KI-Tools direkt mit deinem Übersetzungs-Workspace:

Unterstützte KI-Tools

Dein KI-Assistent kann Keys erstellen, Inhalte übersetzen, Glossare verwalten, ausstehende Änderungen anzeigen und veröffentlichen — alles über natürliche Sprache.

Mehr über MCP-Integration →

CLI

Das @better-i18n/cli integriert sich in deinen Entwicklungs-Workflow:

Scan: Fest kodierte Zeichenketten erkennen

npx @better-i18n/cli scan --ci

Findet nicht übersetzte Texte in React/Next.js-Code. Unterstützt useTranslations(), getTranslations(), JSX-Text und Attribute.

Sync: Lokal vs. Cloud vergleichen

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

Zeigt, welche Keys im Code, aber nicht in der Cloud vorhanden sind (fehlend), und welche Cloud-Keys im Code nicht verwendet werden (ungenutzt).

CI/CD-Integration

# GitHub Actions
- run: npx @better-i18n/cli scan --ci      # PRs mit fest kodierten Zeichenketten blockieren
- run: npx @better-i18n/cli sync --format json  # Übersetzungsabdeckung prüfen

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

Mehr über die CLI →

REST API

Voller programmatischer Zugriff auf alle Übersetzungsmanagement-Operationen:

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

API-Keys werden im Dashboard erstellt, auf bestimmte Projekte beschränkt und können sofort widerrufen werden.

Mehr über die REST API →

Content SDK

Ein Supabase-ähnlicher Query Builder zum Abrufen lokalisierter Inhalte:

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);

Keine Abhängigkeiten, vollständig in TypeScript typisiert, funktioniert in jeder JavaScript-Laufzeit.

Mehr über das Content SDK →

Framework-SDKs

Alle SDKs verwenden denselben CDN-Endpoint und dieselbe Namespace-Struktur. Deine Web- und Mobile-Apps teilen sich eine einzige Quelle der Wahrheit für Übersetzungen.

CDN

Übersetzungen werden vom Cloudflare-Edge-Netzwerk ausgeliefert:

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

• Unter 100 ms Lieferzeit weltweit (300+ Edge-Standorte)
• Updates propagieren innerhalb von Sekunden nach der Veröffentlichung
• Kein App-Redeployment für Übersetzungsänderungen erforderlich
• Manifest-Endpoint für die Sprachentdeckung

Mehr über CDN-Auslieferung →

Benutzerdefinierte Integrationen

Die REST API und das Content SDK ermöglichen benutzerdefinierte Integrationen mit jedem System:

• Interne Tools — Übersetzungsmanagement in deine Admin-Panels integrieren
• Automatisierte Workflows — Übersetzungen aus deiner Event-Pipeline auslösen
• Benutzerdefinierte Dashboards — Übersetzungsmetriken in deine Analytics einspeisen
• Content-Pipelines — Lokalisierte Inhalte in dein CMS integrieren

Jede Operation, die im Dashboard verfügbar ist, ist auch über die API zugänglich. Wenn du einen HTTP-Request stellen kannst, kannst du dich mit better-i18n integrieren.

Erste Schritte

1. GitHub — Repository in den Projekteinstellungen verbinden
2. MCP — npx @better-i18n/mcp zur Konfiguration deines KI-Tools hinzufügen
3. CLI — npm install -D @better-i18n/cli
4. API — API-Key unter dash.better-i18n.com/settings/api-keys generieren

Alle Integrationen sind in jedem Plan verfügbar, einschließlich des kostenlosen Tarifs.