@intlayer/docs 9.4.0-canary.0 → 9.4.1

package/docs/fr/packages/intlayer/getLocalizedPath.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 La fonction `getLocalizedPath` résout un chemin canonique (chemin interne de l'application) en son équivalent localisé en fonction de la locale fournie et des règles de réécriture. Elle est particulièrement utile pour générer des URLs optimisées pour le SEO qui varient selon la langue.
 
+C'est l'équivalent relatif de [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedUrl.md) — pour une entrée relative, les deux retournent la même valeur. Contrairement à `getLocalizedUrl`, il ne retourne jamais une URL absolue : la configuration `domains` est ignorée, donc une locale servie depuis son propre domaine produit quand même un chemin. Une entrée absolue est acceptée, mais son origine est supprimée — seuls son chemin, sa chaîne de requête et son hash sont conservés.
+
 **Fonctionnalités clés :**
 
 - Prend en charge les paramètres de route dynamiques en utilisant la syntaxe `[param]`.
@@ -60,13 +62,17 @@ getLocalizedPath(
   - **Type** : `string`
   - **Required** : Oui
 
-- `locale: Locales`
-  - **Description** : La locale cible pour laquelle le chemin doit être localisé.
-  - **Type** : `Locales`
-  - **Required** : Oui
-
 ### Paramètres optionnels
 
+- `locale?: Locales`
+  - **Description**: La locale cible pour laquelle le chemin doit être localisé.
+  - **Type**: `Locales`
+  - **Default**: La locale par défaut de la configuration de votre projet.
+
+- `options?: object`
+  - **Description**: Overrides de routage. Chaque entrée utilise par défaut la configuration de votre projet.
+  - **Type**: `object`
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **Description** : Un objet définissant des règles de réécriture personnalisées. Si non fourni, il prend par défaut la propriété `routing.rewrite` de la configuration de votre projet.
   - **Type** : `RoutingConfig['rewrite']`
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **Type** : `string`
 - **Description** : Le chemin localisé pour la locale spécifiée.
 
+Le type est affiné à partir des règles de réécriture déclarées dans votre configuration, donc l'éditeur affiche le chemin résolu plutôt qu'une simple `string` :
+
+```typescript codeFormat="typescript"
+// Configuration: mode 'prefix-no-default', defaultLocale 'en',
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (aucune règle de réécriture ne correspond, seul le préfixe est appliqué)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+Le même narrowing s'écoule dans [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/intlayer/getLocalizedUrl.md), qui applique les règles de réécriture avant de préfixer la locale.
+
+Deux cas restent élargis à `string`, car ils ne peuvent pas être résolus au moment de la compilation :
+
+- un chemin qui n'est pas une chaîne de caractères littérale (par exemple, construite à partir d'une variable) ;
+- un chemin correspondant à une règle utilisant un paramètre multi-segment ou optionnel (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## Exemple d'utilisation
@@ -126,8 +154,6 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Sortie : "/contactez-nous"
 ```
 
----
-
 ### Omission de la locale
 
 Quand aucune locale n'est donnée, le chemin est localisé pour la locale par défaut configurée :

package/docs/fr/packages/intlayer/getLocalizedUrl.md

@@ -143,36 +143,6 @@ getLocalizedUrl(
 // Résultat : "/about" pour la locale par défaut (anglais)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Résultat : "/fr/about" pour la locale française
-// Résultat : "/about" pour la locale par défaut (anglais)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// Résultat : "/fr/about" pour la locale française
-// Résultat : "/about" pour la locale par défaut (anglais)
-```
-
 ### Remplacement Partiel de la Configuration
 
 Vous pouvez également fournir uniquement certains paramètres optionnels. La fonction utilisera la configuration de votre projet pour tous les paramètres que vous ne spécifiez pas :
@@ -249,6 +219,12 @@ getLocalizedUrl(
 - **Locales non supportées :**
   - Pour les locales non listées dans `locales`, la fonction n'applique aucun préfixe.
 
+- **Modes de routage :**
+  - `'prefix-no-default'` : La locale par défaut n'a pas de préfixe, les autres en ont (par ex., `/about`, `/fr/about`)
+  - `'prefix-all'` : Toutes les locales ont des préfixes (par ex., `/en/about`, `/fr/about`)
+  - `'no-prefix'` : Pas de préfixes de locale dans les URLs (locale gérée ailleurs)
+  - `'search-params'` : Locale spécifiée via paramètre de requête (par ex., `/about?locale=fr`)
+
 ---
 
 ## Utilisation dans les applications

package/docs/fr/packages/intlayer/getMultilingualUrls.md

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### Différents Modes de Routage
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **Langues non prises en charge :**
   - Seules les langues fournies dans le tableau `locales` sont prises en compte pour générer les URLs.
 
+- **Modes de routage :**
+  - `'prefix-no-default'`: La locale par défaut n'a pas de préfixe, les autres en ont (ex. : `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: Toutes les locales ont des préfixes (ex. : `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: Aucun préfixe de locale dans les URLs (toutes les locales retournent la même URL)
+  - `'search-params'`: Locale spécifiée via un paramètre de requête (ex. : `/dashboard?locale=fr`)
+
 ---
 
 ## Utilisation dans les applications

package/docs/fr/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 La fonction `getTranslationContent` récupère le contenu correspondant à une locale spécifique à partir d'un ensemble de contenus linguistiques personnalisables. Si la locale spécifiée n'est pas trouvée, elle retourne par défaut le contenu de la locale par défaut configurée dans le projet.
 
+Pour plus de détails sur la façon de déclarer les traductions, consultez la [documentation Translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/translation.md).
+
 ## Paramètres
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/fr/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ Dans `next-intlayer`, la langue courante est gérée via des fournisseurs de con
 
 #### Exemple :
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## Erreurs courantes et dépannage

package/docs/fr/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ Les instructions pour configurer les fichiers de déclaration de contenu sont di
 
 Voici comment vous pouvez implémenter le hook `useIntlayer` dans une page Next.js pour charger dynamiquement le contenu localisé en fonction de la locale actuelle de l'application :
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/fr/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ Le hook `useLocale` accepte les paramètres suivants :
 
 ## Valeurs de retour
 
+Lorsque vous invoquez le hook `useLocale`, il retourne un objet contenant les propriétés suivantes :
+
 - **`locale`** : La langue actuelle telle que définie dans le contexte React.
 - **`defaultLocale`** : La langue principale définie dans la configuration.
 - **`availableLocales`** : Une liste de toutes les langues disponibles telles que définies dans la configuration.

package/docs/fr/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Toutes les clés du dictionnaire doivent être déclarées dans des fichiers de
 
 Exemples d'utilisation du hook `useI18n` dans des composants React :
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/fr/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ Cette section fournit des instructions détaillées sur l'utilisation du hook `u
 
 ## Exemple d'utilisation dans React
 
-Démonstration du hook `useIntlayer` dans un composant React :
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/fr/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 Le plugin Vite `intlayerPrune` permet d'effectuer du tree-shaking et de supprimer les dictionnaires inutilisés du bundle de votre application. Cela aide à réduire la taille finale du bundle en n'incluant que le contenu multilingue nécessaire.
 
+> Le plugin est déjà inclus et configuré automatiquement lorsque vous utilisez [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/packages/vite-intlayer/intlayer.md). Vous n'avez besoin de l'enregistrer manuellement que si vous composez vous-même la pile de plugins.
+
 ## Utilisation
 
 ### Dans le cadre de `intlayer()` (recommandé)

package/docs/fr/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.fr.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "fr", // Important
+  "content": {
+    "multilingualContent": "Titre de mon composant",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Recommandé : Ce format est idéal lorsque vous utilisez l'éditeur visuel d'Intlayer ou que vous gérez les traductions directement dans le code.
 
+> Remarque : Dans les deux cas, le fichier de déclaration de contenu doit suivre le modèle de nommage `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` pour être reconnu par Intlayer. Le suffixe `.[locale]` est optionnel et utilisé uniquement comme convention de nommage.
+
 ### Configuration globale pour les fichiers par locale
 
 Vous pouvez configurer la configuration globale pour les fichiers par locale en ajoutant ce qui suit à votre fichier intlayer.config.ts :
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Important
-  "content": {
-    "multilingualContent": "Titre de mon composant",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Important : Assurez-vous que le champ locale est défini. Il indique à Intlayer la langue que représente le fichier.
 
-> Remarque : Dans les deux cas, le fichier de déclaration de contenu doit suivre le modèle de nommage `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` pour être reconnu par Intlayer. Le suffixe `.[locale]` est optionnel et utilisé uniquement comme convention de nommage.
-
 ## Mélange des formats
 
 Vous pouvez combiner les deux approches de déclaration pour la même clé de contenu. Par exemple :

package/docs/fr/readme.md

@@ -225,8 +225,8 @@ Explorez notre documentation exhaustive pour commencer avec Intlayer et apprendr
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Explorez notre documentation exhaustive pour commencer avec Intlayer et apprendr
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/fr/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Vous pouvez toujours affiner par dictionnaire en utilisant le champ `autoFill` dans les fichiers de contenu. Consultez la référence complète dans `doc/autoFill` et `doc/dictionary/content_file`.
 
+Vous pouvez toujours affiner par dictionnaire en utilisant le champ `autoFill` dans les fichiers de contenu. Intlayer considérera d'abord la configuration par dictionnaire, puis basculera vers la configuration globale. Consultez la référence complète dans [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/autoFill.md) et [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/dictionary/content_file.md).
+
 ---
 
 ## Commande fill : valeurs par défaut plus sûres
@@ -169,6 +171,12 @@ L'extension inclut désormais un onglet Intlayer dédié dans la barre d'activit
 - Barre d'outils dans la vue Dictionnaires : Construire, Pull, Push, Remplir, Actualiser, Tester, Créer un fichier de dictionnaire
 - Menus contextuels : Pull/Push sur les dictionnaires ; Remplir sur les fichiers
 
+Voir les détails dans la documentation de l'[extension officielle VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/vs_code_extension.md).
+
+---
+
+Mise à jour du serveur MCP pour supporter les nouvelles fonctionnalités.
+
 - Révélation automatique : le fichier actuellement ouvert dans l’éditeur est mis en surbrillance dans l’arborescence des dictionnaires lorsque cela est applicable
 - Nouvelles commandes disponibles depuis la Palette de commandes : Remplir les dictionnaires et Tester les dictionnaires
 
@@ -297,8 +305,6 @@ Notes :
 
 Voir [CMS et synchronisation en direct](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/intlayer_CMS.md) et [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md) pour un guide complet.
 
----
-
 ## Processus parallèle pour surveiller les fichiers sur turbopack
 
 Lors de l'utilisation de Turbopack sur Next.js 14 et versions ultérieures comme serveur de développement avec la commande `next dev --turbopack`, les modifications du dictionnaire ne seront pas détectées automatiquement par défaut.

package/docs/fr/releases/v9.md

@@ -370,6 +370,8 @@ 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.
 
+---
+
 ## 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 :

package/docs/fr/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 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 :
 
+Une seule commande installe tout :
+
 ```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`.
 
+La seule dépendance externe est **MongoDB** : le backend se connecte à un cluster MongoDB **Atlas**, que vous fournissez. Tout le reste s'exécute à l'intérieur du conteneur.
+
 ## Table des matières
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (utilisé pour la génération de captures d'écran Puppeteer) est int
 - Ports `3000`, `3100`, `8025`, `9000` et `9001` disponibles sur l'hôte.
 - Un hôte Linux ou macOS (ou WSL2 sur Windows).
 
+Tout le reste — Bun, Redis, MinIO, Chromium — est fourni dans l'image.
+
 ---
 
 ## Démarrage rapide
 
+### 1. Exécuter l'installateur
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-Ce que fait l'installateur :
+Il vérifie que Docker est installé et en cours d'exécution, écrit `./intlayer.env` avec `BETTER_AUTH_SECRET` et `S3_SECRET_ACCESS_KEY` déjà générés, et télécharge l'image. Il ne démarre pas le conteneur — le backend ne peut pas démarrer sans vos identifiants de base de données.
+
+Réexécuter l'installateur est sûr : un `intlayer.env` existant n'est jamais écrasé, il sert donc également de chemin de mise à niveau.
+
+### 2. Remplissez vos identifiants
+
+Ouvrez `intlayer.env` et complétez les valeurs marquées `TODO` :
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Le fichier contient également des blocs commentés pour les fonctionnalités optionnelles — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, et les fournisseurs OAuth. Décommentez ce dont vous avez besoin.
+
+> Le fichier est lu par `docker run --env-file`, qui ne supprime pas les guillemets et traite tout ce qui suit `=` comme la valeur. Écrivez des valeurs nues et gardez les commentaires sur leurs propres lignes.
+
+### 3. Démarrer le conteneur
+
+Ceci est la commande que l'installateur affiche à la fin :
+
+```sh
+docker run -d --name intlayer \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+Ouvrez ensuite **http://localhost:3000**. Le premier démarrage initialise les datastores, donc patientez une minute.
+
+> Le tableau de bord est servi sur `localhost`. Voir [Limitations](#limitations) — les domaines personnalisés ne sont pas pris en charge par l'image publiée.
 
-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`.
+### Paramètres du programme d'installation
 
-Une fois la stack démarrée, ouvrez **http://localhost:3000** et créez votre premier compte.
+Le programme d'installation lit quelques variables d'environnement. Comme il est dirigé vers `sh`, transmettez-les au shell plutôt qu'à `curl` :
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| Variable                  | Par défaut                                    | Description                       |
+| ------------------------- | --------------------------------------------- | --------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Image à télécharger               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Où écrire le fichier env          |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nom du conteneur                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Volume nommé monté à `/data`      |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Port hôte pour le tableau de bord |
+| `INTLAYER_API_PORT`       | `3100`                                        | Port hôte pour l'API              |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Port hôte pour l'API S3 MinIO     |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Port hôte pour la console MinIO   |
+
+> Les quatre variables de port ne modifient que le côté **hôte** du mappage imprimé dans la commande `docker run`. L'image publiée a `http://localhost:3000`, `http://localhost:3100` et `http://localhost:9000` compilés dans le bundle du tableau de bord au moment de la compilation, donc les remapper laisse le navigateur pointant vers les anciens ports. Conservez les valeurs par défaut sauf si vous construisez votre propre image — voir [Limitations](#limitations).
 
 ---
 
@@ -103,8 +161,6 @@ Une fois qu'un admin existe, `/init` redirige vers la page de connexion standard
 | **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`.
 
 ---
@@ -160,8 +216,6 @@ Les ports internes (mongo, redis) ne sont pas exposés à l'hôte par défaut.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Connexion OAuth LinkedIn                                        |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Connexion OAuth Atlassian                                       |
 
----
-
 ### Mailer global
 
 Par défaut, tous les emails transactionnels sont envoyés via Resend en utilisant `RESEND_API_KEY`. Les déploiements auto-hébergés peuvent à la place router **tous** les emails — y compris les emails non-organisationnels tels que les réinitialisations de mot de passe et les liens magiques — via un mailer global configuré avec des variables d'environnement.
@@ -247,16 +301,8 @@ 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
@@ -320,15 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Recherchez `MongoDB connection error` près du haut du journal.
+
 ### 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
-```
-
 ### 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 :

package/docs/hi/benchmark/tanstack.md

@@ -194,6 +194,8 @@ GitHub सितारे किसी प्रोजेक्ट की लो
 
 `Tolgee` पहले उल्लेखित कई मुद्दों को संबोधित करता है। मुझे लगा कि इसे शुरू करना समान दृष्टिकोण वाले अन्य उपकरणों की तुलना में कठिन है। यह टाइप सेफ्टी प्रदान नहीं करता है, जिससे कंपाइल समय पर गायब कीज़ को पकड़ना भी बहुत कठिन हो जाता है। गायब-की पहचान जोड़ने के लिए मुझे Tolgee की APIs को अपनी APIs के साथ रैप करना पड़ा।
 
+पैकेज काफी भारी है (~11.1kb, जो `react-intlayer` से 2× अधिक है)।
+
 TanStack Start पर मुझे रिएक्टिविटी की समस्याएं भी थीं: लोकेल बदलने पर, मुझे प्रोवाइडर को री-रेंडर करने के लिए मजबूर करना पड़ा और लोकेल-चेंज इवेंट्स को सब्सक्राइब करना पड़ा ताकि दूसरी भाषा में लोडिंग सही ढंग से व्यवहार करे।
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ TanStack Start पर आप Next.js-विशिष्ट जाल ( `setReque
 
 फिर भी, यह `t('a.b.c')` पर बने स्टैक्स जैसी ही प्रमुख कमियाँ साझा करता है: अनुकूलन संभव है लेकिन बहुत समय लेने वाला है, और बड़ी परियोजनाओं में खराब प्रथाओं (नेमस्पेस + डायनेमिक लोडिंग + टाइप्स) में गिरने का जोखिम होता है।
 
+पैकेज विशेष रूप से भारी है (~17.3kb, जो `react-intlayer` का लगभग 3.5× है)।
+
 मैसेज फॉर्मेट्स भी भिन्न हैं: `use-intl` ICU MessageFormat का उपयोग करता है, जबकि `i18next` अपने स्वयं के फॉर्मेट का उपयोग करता है-जो टूल्स या माइग्रेशन को जटिल बनाता है यदि आप उन्हें मिलाते हैं।
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ TanStack Start पर आप Next.js-विशिष्ट जाल ( `setReque
 
 `react-intl` Format.js टीम का एक परफॉरमेंट कार्यान्वयन है। DX वर्बोस (verbose) रहता है: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` जटिलता, अतिरिक्त जावास्क्रिप्ट कार्य जोड़ता है और ग्लोबल i18n इंस्टेंस को React ट्री के कई नोड्स से जोड़ता है।
 
+पैकेज भी भारी है (~14.4kb, जो `react-intlayer` का लगभग 3× है)।
+
 ### 4 - सिफारिशें
 
 इस TanStack Start बेंचमार्क का `next-translate` (Next.js प्लगइन + `getStaticProps`) के बराबर कोई सीधा विकल्प नहीं है। उन टीमों के लिए जो वास्तव में परिपक्व ईकोसिस्टम वाली `t()` API चाहती हैं, `react-i18next` और `use-intl` "उचित" विकल्प बने हुए हैं, लेकिन लीकेज से बचने के लिए अनुकूलन में बहुत समय निवेश करने के लिए तैयार रहें।