better-i18n.com
Docs développeurCentre d'aideNotes de version

Comment créer mon premier projet ?

Mis à jour le Aug 21, 2026Ali Osman Delişmen

Un projet contient les clés, les langues et les paramètres d'une application ou d'un site. Sa création prend une minute ; les deux points à ne pas manquer sont la langue source et l'endroit où atterrit votre clé.

Le créer #

  1. Connectez-vous sur app.better-i18n.com
  2. New Project
  3. Nommez-le — ce nom devient le slug du projet, gardez-le court
  4. Choisissez la langue source : celle dans laquelle votre code est écrit
  5. Ajoutez les langues vers lesquelles traduire
  6. Create

Créez votre projet — saisissez un nom et choisissez votre langue source

La langue source est le seul choix qui demande réflexion. Toutes les traductions en sont issues et le texte original de chaque clé y réside. Vous pourrez la changer plus tard dans Settings → CDN, mais elle sert de référence à tout le reste : partez donc de la langue dans laquelle vous écrivez réellement.

Les langues cibles se changent facilement — ajoutez-les et retirez-les depuis la page Languages quand vous voulez.

Votre identifiant de projet #

Chaque projet s'adresse sous la forme org/project — acme/dashboard. Vous le saisirez dans la configuration du SDK, dans celle de la CLI et dans chaque appel d'API.

Créer une clé API #

Settings → API Keys → Create Key.

Create API Key — donnez un nom à votre clé et cliquez sur Create Key

Donnez-lui un nom que vous reconnaîtrez dans six mois (« CI », « local dev ») et choisissez une échéance : 3 mois, 6 mois, 1 an ou jamais. La liste indique la durée restante de chaque clé et vous prévient un mois avant son expiration — une clé qui meurt en silence dans la CI, c'est un après-midi gâché.

La clé n'est affichée qu'une fois. Copiez-la dès son apparition : vous ne pourrez plus la relire, seulement la remplacer.

Quelle clé, à quel endroit #

LectureÉcritureSûre dans un navigateur
Clé CDN / de diffusion✓—✓
Clé API✓✓Non

La clé CDN ne récupère que les traductions publiées, des données publiques que vos visiteurs téléchargent de toute façon. La clé API peut modifier votre projet : sa place est dans une variable d'environnement serveur ou dans les secrets de votre CI — jamais dans du code client, jamais dans un fichier versionné.

Si une clé secrète se retrouve malgré tout exposée : révoquez-la depuis la page API Keys et créez-en une autre. La révocation est immédiate.

Pointer votre application vers le projet #

Bash
# .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=...
TypeScript
// L'appel exact dépend de votre framework — voir le guide du SDK
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

La suite #