@intlayer/docs 9.0.0-canary.8 → 9.0.0

package/docs/fr/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,23 @@ Les étapes suivantes sont le minimum requis pour faire fonctionner votre applic
 Installez les packages principaux d'Intlayer et l'adaptateur de compatibilité :
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > l'indicateur `--interactive` est facultatif. Utilisez `intlayer-cli init` si vous êtes un agent IA.

package/docs/fr/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Nouvel Intlayer v9 - Quoi de neuf ?
 description: Découvrez les nouveautés d'Intlayer v9. Présentation des packages de compatibilité prêts à l'emploi pour les bibliothèques i18n populaires et prise en charge des Collections et Variants.
 keywords:
@@ -9,9 +9,13 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=ia6JmVf-kkU
 slugs:
   - doc
   - releases
@@ -23,6 +27,14 @@ author: aymericzip
 
 Bienvenue sur Intlayer v9 ! Cette version majeure marque une étape importante dans la simplification du chemin de migration vers Intlayer avec les **packages d'adaptateurs de compatibilité** pour les principales bibliothèques i18n (`react-i18next`, `next-intl`, `vue-i18n`, etc.) et ajoute la prise en charge de structures de contenu riches : les **Collections** et les **Variants**.
 
+<iframe
+  src="https://www.youtube.com/embed/ia6JmVf-kkU"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## Table des matières
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,28 +121,40 @@ Intlayer v9 va au-delà des objets clé-valeur statiques, permettant aux diction
 
 Définissez une liste d'éléments ordonnés gérée par un CMS (par exemple, FAQ, produits ou listes de blogs) :
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({ fr: "Qu'est-ce qu'Intlayer ?", en: "What is Intlayer?" }),
-      answer: t({ fr: "Une boîte à outils i18n.", en: "An i18n toolkit." }),
-    },
-  ],
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### Utilisation :
 
 ```ts
-// Récupérer tous les éléments
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Récupérer un seul élément par index
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. Variants
@@ -180,28 +204,52 @@ export default {
 ```ts
 // Récupère uniquement l'élément demandé dynamiquement (nécessite Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## Chargement dynamique et optimisations de la taille du bundle
-
-Pour maintenir les bundles extrêmement petits, Intlayer v9 prend en charge le chargement paresseux dynamique.
-
-Dans votre configuration, définissez `importMode` sur `'dynamic'` ou `'fetch'` :
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics` : suivi de l'exposition du contenu et tests A/B
+
+Un nouveau package optionnel, [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md), vous indique quel contenu est réellement affiché à vos visiteurs — et boucle la boucle avec **Collections & Variants** en vous permettant de faire des tests A/B sur le contenu et de mesurer les conversions par variante.
+
+- **Suivi au niveau du provider** : `IntlayerProvider` (React / Next.js / React Native) enregistre automatiquement des événements `page_view` au chargement, au changement de route et au changement de langue.
+- **Suivi au niveau du nœud** : chaque résolution de `useIntlayer` remonte un événement `content_exposure` — quelle clé de dictionnaire, quel chemin de clé, quelle langue et, le cas échéant, quelle **variante** A/B a été affichée. Les expositions répétées d'un même nœud dans une fenêtre d'envoi sont regroupées.
+- **Attribution déterministe des variantes A/B** : `getVariant(experimentKey, variants)` attribue une variante à chaque session **sans aller-retour serveur**, donc aucun scintillement avant le premier rendu.
+- **`useConversion()`** : attribue un objectif (inscription, clic, achat…) à la variante à laquelle la session a été exposée.
+- **Coût nul si non installé** : même schéma tree-shakeable que `@intlayer/editor` — `import()` dynamique enveloppé dans un `try/catch`, plus une variable d'environnement à la compilation (`INTLAYER_ANALYTICS_ENABLED`) qui élimine complètement l'intégration du bundle pour les applications qui ne l'activent pas.
+- **Aucun nouveau schéma de configuration** : réutilise `editor.backendURL` (point d'envoi / auto-hébergement) et `editor.clientId` (clé de projet, qui sert aussi d'interrupteur d'activation).
+- **Respect de la vie privée** : hachage anonyme de session (SHA-256, aucun identifiant brut stocké), aucun stockage d'IP, géolocalisation grossière limitée au pays, requêtes envoyées par lots environ toutes les 20 secondes.
+- **Tableau de bord** : une nouvelle page **Analytics** (affichée dans la barre latérale une fois un projet sélectionné) indique les utilisateurs actifs, les utilisateurs du jour, ceux des 7/30/90 derniers jours, un graphique d'évolution des visiteurs, ainsi que la répartition par langue et par localisation.
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-Au moment de la compilation, `@intlayer/swc` et `@intlayer/babel` analysent vos fichiers et remplacent les appels `useIntlayer` / `getIntlayer` par des wrappers optimisés par tree-shaking (`useDictionary` / `useDictionaryDynamic`). Seul le contenu requis pour l'élément de collection, le variant ou la locale sélectionné est chargé, empêchant ainsi votre bundle de production de contenir des traductions inutilisées.
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+Disponible dès aujourd'hui pour React, Next.js et React Native (via `react-intlayer`) ; les intégrations pour d'autres frameworks (Vue, Svelte, Angular, …) sont prévues, en suivant le même schéma de déploiement que `@intlayer/editor`. Consultez la [documentation Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) pour le guide complet.
 
 ---
 
@@ -284,13 +332,68 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## SDK CMS : utilisez Intlayer comme une base de données de contenu headless
+
+Intlayer v9 fournit un SDK clair et auto-authentifié dans `@intlayer/api` pour interagir avec le CMS de manière programmatique — récupérer des projets, récupérer des dictionnaires, et les pousser ou les mettre à jour depuis votre propre serveur, vos scripts ou votre CI. L'authentification (OAuth2 `client_credentials`) est gérée et rafraîchie pour vous.
+
+Le SDK est divisé en **deux imports distincts** afin que votre bundle n'inclue que les domaines que vous utilisez réellement :
+
+1. `createIntlayerCMS` — un **authentificateur** léger qui détient les identifiants et le jeton géré (aucun client de domaine n'est inclus).
+2. `dictionaryEndpoint`, `projectEndpoint`, … — des **lieurs d'endpoint** par domaine, chacun importé depuis son propre sous-chemin.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// La configuration est optionnelle : les identifiants reviennent à INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET résolus par `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// Lecture
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// Écriture — utilisez le CMS comme une base de données
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> Sécurité : les identifiants du CMS accordent un accès en écriture à votre contenu. Créez toujours l'authentificateur **côté serveur** uniquement — n'envoyez jamais `clientId` / `clientSecret` au navigateur.
+
+---
+
+## Auto-hébergement
+
+Intlayer v9 offre une prise en charge de première classe pour exécuter votre propre instance Intlayer avec une seule commande — aucun compte Intlayer Cloud requis.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Le programme d'installation télécharge un `docker-compose.yml` et un `.env`, génère automatiquement les secrets requis et exécute `docker compose up -d`. Tout — le tableau de bord, l'API, la base de données, le stockage d'objets et les e-mails transactionnels — s'exécute localement dans des conteneurs.
+
+### Services inclus
+
+| Service                                 | Objectif                                                                             |
+| --------------------------------------- | ------------------------------------------------------------------------------------ |
+| **app** (TanStack Start)                | Interface du tableau de bord sur le port `3000`                                      |
+| **backend** (Fastify/Bun)               | API REST sur le port `3100`                                                          |
+| **MongoDB 7** (single-node replica set) | Base de données principale                                                           |
+| **Redis 7**                             | Files d'attente de tâches et mise en cache                                           |
+| **MinIO**                               | Stockage d'objets compatible S3 (avatars, captures d'écran)                          |
+| **Mailpit**                             | Puits SMTP local + interface web pour les e-mails transactionnels sur le port `8025` |
+
+Chromium (utilisé pour la génération de captures d'écran Puppeteer) est intégré dans l'image du backend — aucun conteneur supplémentaire n'est nécessaire.
+
+---
+
 ## Notes de migration depuis la v8
 
 Si vous effectuez une mise à niveau depuis la v8, notez que la v9 n'inclut pas de changements majeurs (breaking changes). Voici cependant les changements clés :
 
 - **Compilateur désactivé par défaut** : `compiler.enabled` vaut désormais `false` par défaut. Si vous dépendez de l'extraction de vos fichiers `.content.ts` au build, définissez `compiler.enabled: true` dans votre `intlayer.config.ts`.
+- **Plugin Vite** : Le compilateur et le proxy de routage de locale sont désormais intégrés dans `intlayer()`. Si vous avez précédemment enregistré `intlayerCompiler()` ou `intlayerProxy()` manuellement, vous pouvez les supprimer — ils sont dédupliqués automatiquement, donc les conserver est sans danger. Utilisez `routing.enableProxy: false` pour désactiver le proxy.
 - **Locales et dialectes** : Si vous utilisez des dépendances i18n externes, ajoutez leurs plugins d'adaptateur de compatibilité respectifs dans votre configuration ou votre setup de bundler pour réécrire automatiquement les imports.
 - **Sélecteurs personnalisés** : Lors de l'appel de `useIntlayer`, le deuxième paramètre est désormais réservé à un objet d'options contenant `{ locale, item, variant }`. Si vous passiez auparavant une chaîne de caractères de locale directement, vous pouvez toujours le faire, mais l'utilisation de l'objet d'options est recommandée pour les sélections avancées.
+- **React Native** : `react-native-intlayer` réexporte désormais l'intégralité de l'API `react-intlayer`. Dans une application React Native, importez tout depuis `react-native-intlayer` et supprimez la dépendance directe à `react-intlayer`. Les imports `react-intlayer` existants continuent de fonctionner.
 
 ---
 
@@ -298,4 +401,7 @@ Si vous effectuez une mise à niveau depuis la v8, notez que la v9 n'inclut pas
 
 - [Guide des packages d'adaptateurs de compatibilité](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/compat/index.md)
 - [Dictionnaires dynamiques - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dynamic_dictionaries/index.md)
+- [Analytics - Suivi de l'exposition du contenu et tests A/B](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [Référence de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md)
+- [SDK CMS - Accès programmatique avec @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)
+- [Guide d'auto-hébergement](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/self_hosting.md)

package/docs/fr/self_hosting.md

@@ -0,0 +1,350 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Auto-hébergement d'Intlayer
+description: Exécutez une instance complète d'Intlayer sur votre propre infrastructure avec une seule commande. Aucun compte Intlayer Cloud n'est requis.
+keywords:
+  - Auto-hébergement
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Auto-hébergement d'Intlayer
+
+Intlayer peut fonctionner entièrement sur votre propre infrastructure — aucun compte Intlayer Cloud n'est requis. Une seule commande démarre une stack prête pour la production :
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+L'installateur télécharge un fichier `docker-compose.yml` et un fichier `.env`, génère automatiquement les secrets requis et démarre tous les conteneurs avec `docker compose up -d`.
+
+## Table des matières
+
+<TOC/>
+
+---
+
+## Architecture
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (utilisé pour la génération de captures d'écran Puppeteer) est intégré à l'image du backend — aucun conteneur séparé n'est nécessaire.
+
+---
+
+## Prérequis
+
+- **Docker** ≥ 24 et **Docker Compose** ≥ v2. Si l'un des deux est manquant, l'installateur affiche le lien d'installation et quitte.
+- Ports `3000`, `3100`, `8025`, `9000` et `9001` disponibles sur l'hôte.
+- Un hôte Linux ou macOS (ou WSL2 sur Windows).
+
+---
+
+## Démarrage rapide
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Ce que fait l'installateur :
+
+1.  Vérifie que `docker` et `docker compose` sont présents.
+2.  Télécharge `docker-compose.yml` et `.env.example` dans `./intlayer/`.
+3.  S'il n'existe pas de fichier `.env`, copie l'exemple et génère des secrets aléatoires pour `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` et `S3_SECRET_ACCESS_KEY` via `openssl rand`.
+4.  Exécute `docker compose pull` + `docker compose up -d`.
+5.  Affiche les URL : tableau de bord `:3000`, API `:3100`, UI e-mail `:8025`, console MinIO `:9001`.
+
+Une fois la stack démarrée, ouvrez **http://localhost:3000** et créez votre premier compte.
+
+---
+
+## Services
+
+| Service     | Image                                           | Port(s) hôte                   | Objectif                                                                 |
+| ----------- | ----------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------ |
+| **app**     | construit à partir de `apps/app/Dockerfile`     | `3000`                         | Tableau de bord TanStack Start (UI du CMS)                               |
+| **backend** | construit à partir de `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                                    |
+| **mongo**   | `mongo:7`                                       | interne                        | Réplica set à nœud unique (`rs0`)                                        |
+| **redis**   | `redis:7-alpine`                                | interne                        | Files d'attente de jobs (BullMQ) et mise en cache (ioredis)              |
+| **minio**   | `minio/minio`                                   | `9000` (S3), `9001` (console)  | Stockage d'objets compatible S3 pour les avatars et les captures d'écran |
+| **mailpit** | `axllent/mailpit`                               | `1025` (SMTP), `8025` (web UI) | Réceptacle local d'e-mails transactionnels                               |
+
+Les ports internes (mongo, redis) ne sont pas exposés à l'hôte par défaut.
+
+> Le port `9000` de MinIO doit être accessible par le navigateur car les assets téléchargés (avatars, captures d'écran) sont chargés directement depuis `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
+
+---
+
+## Variables d'environnement
+
+L'installateur génère un fichier `.env` prêt à l'emploi. Le tableau ci-dessous décrit chaque variable.
+
+### Requis (auto-généré ou demandé)
+
+| Variable               | Exemple                                         | Description                                                        |
+| ---------------------- | ----------------------------------------------- | ------------------------------------------------------------------ |
+| `NODE_ENV`             | `production`                                    | Environnement d'exécution                                          |
+| `PORT`                 | `3100`                                          | Port d'écoute du backend                                           |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL publique de l'API backend                                      |
+| `APP_URL`              | `http://localhost:3000`                         | URL publique du tableau de bord                                    |
+| `DOMAIN`               | `localhost`                                     | Domaine du cookie                                                  |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI de connexion complète à MongoDB                                |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL de connexion Redis                                             |
+| `BETTER_AUTH_SECRET`   | _(généré)_                                      | Secret de 32 octets pour la signature de session                   |
+| `MAIL_PROVIDER`        | `smtp`                                          | Transport de courrier : `smtp` ou `resend`                         |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Nom d'hôte SMTP (nom du conteneur Mailpit)                         |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Port SMTP                                                          |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Adresse de l'expéditeur                                            |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatible S3                                             |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL publique pour le chargement des assets par le navigateur       |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nom du bucket                                                      |
+| `S3_ACCESS_KEY_ID`     | _(généré)_                                      | Clé d'accès MinIO                                                  |
+| `S3_SECRET_ACCESS_KEY` | _(généré)_                                      | Clé secrète MinIO                                                  |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL du backend intégrée au tableau de bord lors de la construction |
+| `VITE_DOMAIN`          | `localhost`                                     | Domaine intégré au tableau de bord lors de la construction         |
+
+### Facultatif (les fonctionnalités se dégradent gracieusement en leur absence)
+
+| Variable                                                 | Fonctionnalité                                                  |
+| -------------------------------------------------------- | --------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traduction assistée par IA et audit de contenu                  |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestion de la facturation et des abonnements                    |
+| `RESEND_API_KEY`                                         | E-mail transactionnel via Resend (outrepasse Mailpit si défini) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Connexion OAuth GitHub                                          |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Connexion OAuth Google                                          |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Connexion OAuth GitLab                                          |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Connexion OAuth Microsoft                                       |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Connexion OAuth LinkedIn                                        |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Connexion OAuth Atlassian                                       |
+
+---
+
+## Connexion de votre projet Intlayer
+
+Une fois la stack en cours d'exécution, pointez votre projet vers le backend et le tableau de bord auto-hébergés au lieu de `intlayer.org`.
+
+### Configuration du projet
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+
+    /**
+     * URL du tableau de bord CMS auto-hébergé.
+     * Par défaut : https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // ex. http://localhost:3000
+
+    /**
+     * URL de l'API backend auto-hébergée.
+     * Par défaut : https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // ex. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Définissez les variables d'environnement dans le fichier `.env` de votre projet :
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Créez des identifiants d'accès dans votre tableau de bord auto-hébergé sous **Projets → Clés d'accès** à l'adresse `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Lorsque vous utilisez le SDK `@intlayer/api` de manière programmatique, passez `backendURL` explicitement :
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+```
+
+---
+
+## Mise à niveau
+
+Exécuter à nouveau l'installateur sur un déploiement existant effectue une mise à niveau progressive :
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Ceci télécharge les dernières images et redémarre les conteneurs avec `docker compose pull && docker compose up -d`. Les volumes existants (`mongo-data`, `redis-data`, `minio-data`) sont préservés — aucune perte de données.
+
+Pour effectuer une mise à niveau manuellement depuis le répertoire `./intlayer/` :
+
+```sh
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## Sauvegarde et restauration
+
+Toutes les données persistantes résident dans trois volumes Docker nommés.
+
+### Sauvegarde
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Restauration
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Répétez pour redis-data et minio-data
+```
+
+---
+
+## Utilisation d'un proxy inverse (Nginx / Caddy)
+
+Pour les déploiements de production, placez un proxy inverse devant les conteneurs de l'application et du backend au lieu de les exposer directement.
+
+### Exemple Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Mettez à jour les variables `.env` suivantes pour qu'elles correspondent à vos domaines publics :
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Les variables `VITE_*` sont intégrées à l'image du tableau de bord lors de la construction. Si vous les modifiez après la construction de l'image, vous devez reconstruire l'image `app` (`docker compose build app`) ou utiliser l'injection de configuration au moment de l'exécution.
+
+---
+
+## Dépannage
+
+### Le backend redémarre en boucle au premier démarrage
+
+MongoDB et Redis doivent être sains avant le démarrage du backend. Le fichier compose utilise `depends_on` avec `condition: service_healthy`. Si vous voyez des redémarrages répétés du backend, vérifiez que les contrôles de santé de `mongo` et `redis` sont réussis :
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### Le tableau de bord ne peut pas atteindre l'API
+
+Vérifiez que `VITE_BACKEND_URL` correspond à l'URL où le backend est accessible depuis le **navigateur** (pas le réseau Docker). Si vous avez modifié le port du backend ou ajouté un proxy inverse, reconstruisez l'image du tableau de bord :
+
+```sh
+docker compose build app
+docker compose up -d app
+```
+
+### Les e-mails ne sont pas envoyés
+
+Par défaut, tous les e-mails sortants sont capturés par Mailpit. Ouvrez `http://localhost:8025` pour voir les messages envoyés. Pour envoyer de vrais e-mails, définissez `MAIL_PROVIDER=resend` et `RESEND_API_KEY=<your-key>` dans `.env`, puis redémarrez le backend :
+
+```sh
+docker compose restart backend
+```
+
+### Bucket MinIO manquant
+
+Si le service ponctuel `minio-init` n'a pas fonctionné (ou a fonctionné avant que MinIO ne soit prêt), créez le bucket manuellement :
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Liens utiles
+
+- [Documentation du CMS Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md)
+- [Référence de configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md#programmatic-access-with-the-intlayerapi-sdk)
+- [Docker Image (aymercizip/intlayer-selfhost)](https://hub.docker.com/repository/docker/aymercizip/intlayer-selfhost/general)

package/docs/hi/bundle_optimization.md

@@ -231,6 +231,9 @@ Next.js को ऑप्टिमाइज़ (import rewrite) पास के
 
 > यह प्लगइन डिफ़ॉल्ट रूप से इंस्टॉल नहीं होता है क्योंकि SWC प्लगइन्स अभी भी Next.js के लिए प्रायोगिक (experimental) हैं। भविष्य में यह बदल सकता है।
 
+<Tabs>
+ <Tab value="npm">
+
 ```bash packageManager="npm"
 npm install -D @intlayer/swc
 ```
@@ -247,6 +250,19 @@ pnpm add -D @intlayer/swc
 bun add -d @intlayer/swc
 ```
 
+ </Tab>
+ <Tab value="Crates.io (rust)">
+
+```toml fileName="Cargo.toml"
+[dependencies]
+intlayer-swc-plugin = "*"
+```
+
+[View on Crates.io](https://crates.io/crates/intlayer-swc-plugin)
+
+ </Tab>
+</Tabs>
+
 एक बार इंस्टॉल हो जाने पर, Intlayer स्वचालित रूप से प्लगइन का पता लगाएगा और उसका उपयोग करेगा।
 
 **purge और minify** पास (फ़ील्ड हटाना और फ़ील्ड का नाम बदलना) के लिए, इसके साथ `@intlayer/babel` इंस्टॉल करें और Babel प्लगइन्स जोड़ें। क्योंकि Next.js ट्रांसफ़ॉर्मेशन के लिए SWC का उपयोग करता है लेकिन फिर भी प्लगइन कॉन्फ़िगरेशन के लिए `babel.config.js` का मूल्यांकन (evaluates) करता है, Babel प्लगइन्स SWC से पहले एक प्री-पास के रूप में चलते हैं।

package/docs/hi/cli/index.md

@@ -125,7 +125,7 @@ Intlayer कई कॉन्फ़िगरेशन फ़ाइल प्र
 
 ### प्रमाणीकरण (Authentication)
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/login.md)** - Intlayer CMS के साथ प्रमाणित हों और एक्सेस क्रेडेंशियल प्राप्त करें
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/login.md)** - Intlayer CMS के साथ प्रमाणित हों और एक्सेस क्रेडेंशियल प्राप्त करें
 
 ### मुख्य कमांड (Core Commands)
 

package/docs/hi/cli/scan.md

@@ -150,10 +150,10 @@ await scan("https://example.com", {
 });
 ```
 
-निम्न-स्तरीय पहुँच के लिए, `@intlayer/chokidar/scan` से `scanWebsite` एक संरचित `ScanResult` ऑब्जेक्ट लौटाता है:
+निम्न-स्तरीय पहुँच के लिए, `@intlayer/engine/scan` से `scanWebsite` एक संरचित `ScanResult` ऑब्जेक्ट लौटाता है:
 
 ```ts
-import { scanWebsite } from "@intlayer/chokidar/scan";
+import { scanWebsite } from "@intlayer/engine/scan";
 
 const result = await scanWebsite("https://example.com", { deep: false });
 console.log(result.score, result.totalPageSize, result.events);