Comment configurer le CLI et scanner mon projet ?

Le CLI Better i18n est un outil de développeur qui scanne votre base de code pour les clés de traduction et les maintient synchronisées avec le tableau de bord.

Installation

# Avec bun (recommandé)
bun add -g @better-i18n/cli

# Avec npm
npm install -g @better-i18n/cli

# Avec pnpm
pnpm add -g @better-i18n/cli

Vérifiez l'installation :

better-i18n --version

Authentification

Connectez-vous avec votre compte Better i18n :

better-i18n login

Cela ouvre une fenêtre de navigateur pour l'authentification. Vos identifiants sont stockés localement et de manière sécurisée.

Configuration du projet

Créez un fichier de configuration à la racine de votre projet :

better-i18n init

Cela génère better-i18n.config.ts :

import { defineConfig } from '@better-i18n/cli';

export default defineConfig({
  project: 'acme/dashboard',
  sourceLocale: 'en',
  // Répertoires à scanner pour les clés de traduction
  include: ['src/**/*.{ts,tsx,js,jsx}'],
  // Répertoires à exclure
  exclude: ['node_modules', 'dist', '.next'],
});

Scanner votre base de code

Exécutez le scanner pour trouver toutes les clés de traduction :

better-i18n scan

Le scanner détecte :

• t('key') — appels de fonction de traduction standard
• t('namespace:key') — clés avec espace de noms
• useTranslations('namespace') — imports d'espace de noms
• Littéraux de gabarit : t(`key.${dynamic}`) (signalé comme clé dynamique)

Résultat du scan

Scanning src/**/*.{ts,tsx}...

 Found 142 translation keys in 38 files
   • common: 24 keys
   • auth: 18 keys
   • dashboard: 45 keys
   • settings: 32 keys
   • (default): 23 keys

 ⚠ 3 dynamic keys detected (review manually)

Synchronisation avec le tableau de bord

Poussez les clés scannées vers Better i18n :

better-i18n sync

Cela :

1. Compare les clés locales avec le tableau de bord
2. Crée les nouvelles clés qui n'existent pas encore
3. Signale les clés présentes dans le tableau de bord mais absentes du code (clés potentiellement mortes)

Vérification du statut de synchronisation

Vérifiez que tout est synchronisé :

better-i18n check

✓ 142 keys in sync
⚠ 3 keys in code but not in dashboard (run sync to fix)
⚠ 5 keys in dashboard but not in code (potential dead keys)

Exécuter doctor

Diagnostiquez les problèmes courants :

better-i18n doctor

Cela vérifie votre configuration, l'authentification, la connectivité API et la configuration du projet.

Intégration CI/CD

Ajoutez better-i18n check à votre pipeline CI pour détecter les traductions manquantes avant la fusion :

# Exemple GitHub Actions
- name: Check translations
  run: better-i18n check --strict

Le drapeau --strict quitte avec le code 1 si des clés ne sont pas synchronisées.

Prochaines étapes

• Configurer le SDK Next.js
• Ajouter vos premières clés de traduction