Intégrations : Connectez better-i18n à votre stack de développement
GitHub pour la synchronisation du code, MCP pour les assistants IA, CLI pour CI/CD, REST API pour les workflows personnalisés. Intégrez better-i18n dans les outils que votre équipe utilise déjà.
Intégrations : Connectez better-i18n à votre stack de développement
better-i18n est conçu API-first. Chaque fonctionnalité est accessible par programmation, et la plateforme s'intègre directement aux outils que les développeurs utilisent au quotidien : GitHub pour le code, les assistants IA pour la productivité, CI/CD pour l'automatisation, et les SDKs de framework pour le runtime.
GitHub
Synchronisation bidirectionnelle entre votre repository et better-i18n :
- Synchronisation entrante — Les événements Push déclenchent l'importation automatique des fichiers de traduction via des webhooks
- Synchronisation sortante — Les traductions publiées sont envoyées sous forme de pull requests vers votre repository
- Patterns de fichiers — Configurez les chemins à synchroniser (ex. :
locales/**/*.json) - Permissions minimales — Lecture/écriture uniquement sur les fichiers de traduction, webhooks pour les événements Push
L'intégration GitHub maintient votre projet cloud et votre repository synchronisés sans intervention manuelle. Vous conservez le contrôle total de fusion sur les PRs de traduction.
En savoir plus sur l'intégration GitHub →
Assistants IA (MCP)
Deux serveurs MCP connectent les outils IA directement à votre workspace de traduction :
| Package | Outils | Objectif |
|---|---|---|
@better-i18n/mcp | 11 outils | Gestion des traductions — clés, traductions, publication |
@better-i18n/mcp-content | 17 outils | Gestion de contenu — modèles, entrées, contenu localisé |
Outils IA pris en charge
| Outil | Méthode de connexion |
|---|---|
| Claude (claude.ai) | Remote MCP URL : https://mcp.better-i18n.com/mcp |
| ChatGPT | Remote MCP URL : https://mcp.better-i18n.com/mcp |
| Gemini | Remote MCP URL : https://mcp.better-i18n.com/mcp |
| Cursor | Local : npx @better-i18n/mcp |
| Claude Code | Local : npx @better-i18n/mcp |
| Windsurf | Local : npx @better-i18n/mcp |
| Zed | Local : npx @better-i18n/mcp |
Votre assistant IA peut créer des clés, traduire du contenu, gérer des glossaires, prévisualiser les changements en attente et publier — le tout en langage naturel.
En savoir plus sur l'intégration MCP →
CLI
Le @better-i18n/cli s'intègre à votre workflow de développement :
Scan : Détecter les chaînes codées en dur
npx @better-i18n/cli scan --ci
Trouve les textes non traduits dans le code React/Next.js. Prend en charge useTranslations(), getTranslations(), le texte JSX et les attributs.
Sync : Comparer local et cloud
npx @better-i18n/cli sync --format json
Montre quelles clés existent dans le code mais pas dans le cloud (manquantes), et quelles clés du cloud ne sont pas utilisées dans le code (inutilisées).
Intégration CI/CD
# GitHub Actions
- run: npx @better-i18n/cli scan --ci # Bloquer les PRs avec des chaînes codées en dur
- run: npx @better-i18n/cli sync --format json # Auditer la couverture des traductions
# Hook pre-commit
npx husky init
echo "npx @better-i18n/cli scan --staged --ci" > .husky/pre-commit
REST API
Accès programmatique complet à toutes les opérations de gestion des traductions :
Base URL : https://dash.better-i18n.com/api
Auth : Authorization: Bearer your-api-key
| Endpoint | Description |
|---|---|
listProjects | Lister tous les projets de votre organisation |
getProject | Obtenir les détails du projet, les langues, les namespaces |
listKeys | Interroger les clés avec des filtres de recherche, namespace et statut |
createKeys | Créer des clés avec le texte source et les traductions |
updateKeys | Mettre à jour les traductions pour les clés existantes |
deleteKeys | Suppression douce des clés inutilisées |
addLanguage | Ajouter des langues cibles à un projet |
Les clés API sont créées dans le tableau de bord, limitées à des projets spécifiques, et révocables instantanément.
En savoir plus sur la REST API →
Content SDK
Un query builder de style Supabase pour récupérer du contenu localisé :
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);
Zéro dépendance, entièrement typé en TypeScript, fonctionne dans tout runtime JavaScript.
En savoir plus sur le Content SDK →
SDKs de Framework
| Framework | Package | Runtime |
|---|---|---|
| Next.js (App Router & Pages) | @better-i18n/next | Server + Client |
| TanStack Start | @better-i18n/use-intl | SSR + Client |
| Vite + React | @better-i18n/use-intl | Client |
| Expo (React Native) | @better-i18n/expo | Client + Offline |
Tous les SDKs utilisent le même endpoint CDN et la même structure de namespace. Vos applications web et mobiles partagent une source unique de vérité pour les traductions.
CDN
Les traductions sont servies depuis le réseau edge de Cloudflare :
https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json
- Livraison en moins de 100 ms dans le monde entier (300+ emplacements edge)
- Les mises à jour se propagent en quelques secondes après la publication
- Aucun redéploiement de l'application nécessaire pour les modifications de traduction
- Endpoint manifest pour la découverte des langues
En savoir plus sur la livraison CDN →
Intégrations personnalisées
La REST API et le Content SDK permettent des intégrations personnalisées avec n'importe quel système :
- Outils internes — Intégrez la gestion des traductions dans vos panneaux d'administration
- Workflows automatisés — Déclenchez des traductions depuis votre pipeline d'événements
- Tableaux de bord personnalisés — Importez les métriques de traduction dans vos analytics
- Pipelines de contenu — Intégrez du contenu localisé dans votre CMS
Chaque opération disponible dans le tableau de bord est également accessible via l'API. Si vous pouvez faire une requête HTTP, vous pouvez vous intégrer avec better-i18n.
Démarrage
- GitHub — Connectez votre repository dans les paramètres du projet
- MCP — Ajoutez
npx @better-i18n/mcpà la configuration de votre outil IA - CLI —
npm install -D @better-i18n/cli - API — Générez une clé API sur dash.better-i18n.com/settings/api-keys
Toutes les intégrations sont disponibles dans tous les plans, y compris le niveau gratuit.