@intlayer/docs 5.5.12 → 5.7.0

package/docs/en/intlayer_with_create_react_app.md

@@ -15,6 +15,7 @@ slugs:
   - doc
   - environment
   - create-react-app
+applicationTemplate: https://github.com/aymericzip/intlayer-react-cra-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and React Create App

package/docs/en/intlayer_with_lynx+react.md

@@ -15,6 +15,7 @@ slugs:
   - doc
   - environment
   - lynx-and-react
+applicationTemplate: https://github.com/aymericzip/intlayer-lynx-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Lynx and React

package/docs/en/intlayer_with_nextjs_14.md

@@ -15,6 +15,7 @@ slugs:
   - environment
   - nextjs
   - 14
+applicationTemplate: https://github.com/aymericzip/intlayer-next-14-template
 ---
 
 # Getting Started internationalizing (i18n) with Intlayer and Next.js 14 with App Router

package/docs/en/intlayer_with_nextjs_15.md

@@ -14,6 +14,8 @@ slugs:
   - doc
   - environment
   - nextjs
+applicationTemplate: https://github.com/aymericzip/intlayer-next-15-template
+youtubeVideo: https://www.youtube.com/watch?v=e_PPG7PTqGU
 ---
 
 # Getting Started internationalizing (i18n) with Intlayer and Next.js 15 App Router
@@ -130,7 +132,7 @@ module.exports = config;
 
 Configure your Next.js setup to use Intlayer:
 
-```typescript filename="next.config.ts" codeFormat="typescript"
+```typescript fileName="next.config.ts" codeFormat="typescript"
 import type { NextConfig } from "next";
 import { withIntlayer } from "next-intlayer/server";
 

package/docs/en/intlayer_with_nuxt.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - nuxt-and-vue
+applicationTemplate: https://github.com/aymericzip/intlayer-nuxt-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Nuxt

package/docs/en/intlayer_with_react_native+expo.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - react-native-and-expo
+applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and React Native

package/docs/en/intlayer_with_vite+preact.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-preact
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-preact-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Preact
@@ -43,17 +44,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer preact-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer preact-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer preact-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -1037,6 +1038,8 @@ module.exports = App;
 
 In parallel, you can also use the `intLayerMiddlewarePlugin` to add server-side routing to your application. This plugin will automatically detect the current locale based on the URL and set the appropriate locale cookie. If no locale is specified, the plugin will determine the most appropriate locale based on the user's browser language preferences. If no locale is detected, it will redirect to the default locale.
 
+> Note that to use the `intLayerMiddlewarePlugin` in production, you need to switch the `vite-intlayer` package from `devDependencies` to `dependencies`.
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import preact from "@preact/preset-vite";

package/docs/en/intlayer_with_vite+react.md

@@ -15,10 +15,14 @@ slugs:
   - doc
   - environment
   - vite-and-react
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
+youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and React
 
+<iframe title="The best i18n solution for Vite and React? Discover Intlayer" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?si=VaKmrYMmXjo3xpk2"/>
+
 See [Application Template](https://github.com/aymericzip/intlayer-vite-react-template) on GitHub.
 
 ## What is Intlayer?
@@ -42,17 +46,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer react-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer react-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -1002,6 +1006,8 @@ const App = () => (
 
 In parallel, you can also use the `intLayerMiddlewarePlugin` to add server-side routing to your application. This plugin will automatically detect the current locale based on the URL and set the appropriate locale cookie. If no locale is specified, the plugin will determine the most appropriate locale based on the user's browser language preferences. If no locale is detected, it will redirect to the default locale.
 
+> Note that to use the `intLayerMiddlewarePlugin` in production, you need to switch the `vite-intlayer` package from `devDependencies` to `dependencies`.
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";

package/docs/en/intlayer_with_vite+solid.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-solid
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-solid-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Solid
@@ -43,17 +44,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer solid-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer solid-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer solid-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/en/intlayer_with_vite+svelte.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-svelte
+# applicationTemplate: https://github.com/aymericzip/intlayer-vite-svelte-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Svelte
@@ -43,17 +44,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer svelte-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer svelte-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer svelte-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**

package/docs/en/intlayer_with_vite+vue.md

@@ -14,6 +14,7 @@ slugs:
   - doc
   - environment
   - vite-and-vue
+applicationTemplate: https://github.com/aymericzip/intlayer-vite-vue-template
 ---
 
 # Getting Started Internationalizing (i18n) with Intlayer and Vite and Vue
@@ -41,17 +42,17 @@ Install the necessary packages using npm:
 
 ```bash packageManager="npm"
 npm install intlayer vue-intlayer
-npm install --save-dev vite-intlayer
+npm install vite-intlayer --save-dev
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer vue-intlayer
-pnpm add --save-dev vite-intlayer
+pnpm add vite-intlayer --save-dev
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer vue-intlayer
-yarn add --save-dev vite-intlayer
+yarn add vite-intlayer --save-dev
 ```
 
 - **intlayer**
@@ -646,6 +647,8 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 
 In parallel, you can also use the `intLayerMiddlewarePlugin` to add server-side routing to your application. This plugin will automatically detect the current locale based on the URL and set the appropriate locale cookie. If no locale is specified, the plugin will determine the most appropriate locale based on the user's browser language preferences. If no locale is detected, it will redirect to the default locale.
 
+> Note that to use the `intLayerMiddlewarePlugin` in production, you need to switch the `vite-intlayer` package from `devDependencies` to `dependencies`.
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat="typescript"
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -938,7 +941,7 @@ By default Intlayer render markdown as string. But Intlayer also provides a way
 
 > To see how to declare markdown content using the `intlayer` package, see the [markdown doc](https://github.com/aymericzip/intlayer/tree/main/docs/en/dictionary/markdown.md).
 
-```ts filename="main.ts"
+```ts fileName="main.ts"
 import MarkdownIt from "markdown-it";
 import { createApp, h } from "vue";
 import { installIntlayer, installIntlayerMarkdown } from "vue-intlayer";

package/docs/en/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2025-06-07
+updatedAt: 2025-07-11
 title: MCP Server Documentation
 description: Explore the features and setup of the MCP Server to optimize your server management and operations.
 keywords:
@@ -18,31 +18,58 @@ slugs:
 
 # Intlayer MCP Server
 
-The **Intlayer MCP (Model Context Protocol) Server** provides AI-powered IDE assistance tailored for the Intlayer ecosystem. Designed for modern developer environments like **Cursor**, **GitHub Copilot workspace**, and any IDE supporting the MCP protocol, this server gives you contextual, real-time support based on your project's setup.
+The **Intlayer MCP (Model Context Protocol) Server** provides AI-powered IDE assistance tailored for the Intlayer ecosystem.
+
+## Where can I use it?
+
+- On modern developer environments like **Cursor**, **VS Code**, and any IDE supporting the MCP protocol.
+- On your favorite AI assistant like **Claude Desktop**, **Gemini**, **ChatGPT**, etc.
 
 ## Why Use the Intlayer MCP Server?
 
 By enabling the Intlayer MCP Server in your IDE, you unlock:
 
+- **Context-Aware Documentation**
+  The MCP server loads and exposes the documentation of Intlayer. To speed up your set up, your migrations, etc.
+  This ensures that code suggestions, command options, and explanations are always up to date and relevant.
+
 - **Smart CLI Integration**
-  Access and run Intlayer CLI commands directly from your IDE interface. View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+  Access and run Intlayer CLI commands directly from your IDE interface. Using the MCP server, you can let your AI assistant run commands like `intlayer dictionaries build` to update your dictionaries, or `intlayer dictionaries fill` to fill your missing translations.
 
-- **Context-Aware Documentation**
-  The MCP server loads and exposes the documentation that corresponds to the version of Intlayer you're using in your project. This ensures that code suggestions, command options, and explanations are always up to date and relevant.
+  > View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+
+## Local server (stdio) vs Remote server (SSE)
+
+The MCP server can be used in two ways:
+
+- Local server (stdio)
+- Remote server (SSE)
+
+### Local server (stdio) (recommended)
+
+Intlayer provides a NPM package that can be installed locally on your machine. It can be installed in your favorite IDE, as VS Code, Cursor, as well as your locale assistant application, as ChatGPT, Claude Desktop, etc.
 
-- **AI-Assisted Development**
-  With project-aware suggestions and autocomplete, the AI assistant can explain your code, recommend CLI usage, or suggest how to use specific features of Intlayer based on your current files.
+This server is the recommended way to use the MCP server. As it integrates all the features of the MCP server, including the CLI tools.
 
-- **Lightweight & Instant Setup**
-  No server maintenance or heavy install required. Just configure your `.cursor/mcp.json` or equivalent MCP config and you're ready to go.
+### Remote server (SSE)
+
+The MCP server can also be used remotely, using the SSE transport method. This server is hosted by Intlayer, and is available at https://mcp.intlayer.org. This server can be accessed publicly, without any authentication, and is free to use.
+
+Note that the remote server does not integrate CLI tools, AI autocompletion, etc. The distant server is only for interaction with the documentation to help your AI assistant with the Intlayer ecosystem.
+
+> Due to server hosting costs, the availability of the remote server cannot be guaranteed. We limit the number of simultaneous connections. We recommend using the local server (stdio) transport method for the most reliable experience.
 
 ---
 
-## Setup Cursor
+## Setup in Cursor
+
+Follow the [official documentation](https://docs.cursor.com/context/mcp) to configure the MCP server in Cursor.
 
 In your project root, add the following `.cursor/mcp.json` configuration file:
 
-```json
+### Local server (stdio) (recommended)
+
+```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
     "intlayer": {
@@ -53,19 +80,36 @@ In your project root, add the following `.cursor/mcp.json` configuration file:
 }
 ```
 
+### Remote server (SSE)
+
+For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
+
+```json fileName=".cursor/mcp.json"
+{
+  "mcpServers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "transport": "sse"
+    }
+  }
+}
+```
+
 This tells your IDE to launch the Intlayer MCP server using `npx`, ensuring it always uses the latest available version unless you pin it.
 
 ---
 
-## Setup VS Code
+## Setup in VS Code
+
+Follow the [official documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) to configure the MCP server in VS Code.
 
 To use the Intlayer MCP Server with VS Code, you need to configure it in your workspace or user settings.
 
-### Workspace Configuration
+### Local server (stdio) (recommended)
 
 Create a `.vscode/mcp.json` file in your project root:
 
-```json
+```json fileName=".vscode/mcp.json"
 {
   "servers": {
     "intlayer": {
@@ -77,72 +121,73 @@ Create a `.vscode/mcp.json` file in your project root:
 }
 ```
 
-### Using the MCP Server in VS Code
+### Remote server (SSE)
 
-1. **Enable Agent Mode**: Open the Chat view (⌃⌘I on Mac, Ctrl+Alt+I on Windows/Linux) and select **Agent** mode from the dropdown.
+For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
 
-2. **Access Tools**: Click the **Tools** button to view available Intlayer tools. You can select/deselect specific tools as needed.
+```json fileName=".vscode/mcp.json"
+{
+  "servers": {
+    "intlayer": {
+      "url": "https://mcp.intlayer.org",
+      "type": "sse"
+    }
+  }
+}
+```
 
-3. **Direct Tool Reference**: Reference tools directly in your prompts by typing `#` followed by the tool name.
+---
 
-4. **Tool Confirmation**: By default, VS Code will ask for confirmation before running tools. Use the **Continue** button options to automatically confirm tools for the current session, workspace, or all future invocations.
+## Set Up in ChatGPT
 
-### Managing the Server
+### Remote server (SSE)
 
-- Run **MCP: List Servers** from the Command Palette to view configured servers
-- Start, stop, or restart the Intlayer MCP server as needed
-- View server logs for troubleshooting by selecting the server and choosing **Show Output**
+Follow the [official documentation](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) to configure the MCP server in ChatGPT.
 
-For more detailed information about VS Code MCP integration, see the [official VS Code MCP documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
+1. Go to the [promt dashboard](https://platform.openai.com/prompts)
+2. Click on `+ Create`
+3. Click on `Tools (Create or +)`
+4. Select `MCP Server`
+5. Click on `Add new`
+6. Fill the following fields:
 
----
+   - URL: `https://mcp.intlayer.org`
+   - Label: `Intlayer MCP Server`
+   - Name: `intlayer-mcp-server`
+   - Authentication: `None`
 
-## Setup with Remote Server (SSE)
+7. Click on `Save`
 
-For connecting to a remote Intlayer MCP server using Server-Sent Events (SSE), you can configure your MCP client to connect to the hosted service.
+---
 
-### Cursor Configuration
+## Set Up in Claude Desktop
 
-Add the following to your `.cursor/mcp.json` configuration file:
+Follow the [official documentation](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) to configure the MCP server in Claude Desktop.
 
-```json
-{
-  "mcpServers": {
-    "intlayer-sse": {
-      "url": "http://mcp.intlayer.com",
-      "transport": "sse"
-    }
-  }
-}
-```
+Path of the config file:
 
-### VS Code Configuration
+- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-Add the following to your `.vscode/mcp.json` configuration file:
+### Local server (stdio) (recommended)
 
-```json
+```json fileName="claude_desktop_config.json"
 {
-  "servers": {
-    "intlayer-sse": {
-      "type": "sse",
-      "url": "http://mcp.intlayer.com"
+  "mcpServers": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["-y", "@intlayer/mcp"]
     }
   }
 }
 ```
 
-This configuration allows you to connect to a remote Intlayer MCP server without needing to run the server locally. The remote server provides the same functionality as the local version but is hosted and maintained externally.
-
 ---
 
 ## Using the MCP Server via CLI
 
 You can also run the Intlayer MCP server directly from the command line for testing, debugging, or integration with other tools.
 
-### Install the MCP Server
-
-First, install the MCP server package globally or use it via npx:
-
 ```bash
 # Install globally
 npm install -g @intlayer/mcp
@@ -151,65 +196,13 @@ npm install -g @intlayer/mcp
 npx @intlayer/mcp
 ```
 
-### Start the Server
-
-To start the MCP server with the inspector for debugging and testing:
-
-```bash
-# Using the built-in start command
-npm run start
-
-# Or directly with npx
-npx @modelcontextprotocol/inspector npx @intlayer/mcp
-```
-
-This will launch the MCP server with an inspector interface that allows you to:
-
-- Test MCP protocol communications
-- Debug server responses
-- Validate tool and resource implementations
-- Monitor server performance
-
-### Development Usage
-
-For development and testing purposes, you can run the server in various modes:
-
-```bash
-# Build and start in development mode
-npm run dev
-
-# Run with custom configuration
-node dist/cjs/index.cjs
-
-# Test the server functionality
-npm test
-```
-
-The server will expose Intlayer-specific tools and resources that can be consumed by any MCP-compatible client, not just Cursor or other IDEs.
-
----
-
-## Features Overview
-
-| Feature        | Description                                                                  |
-| -------------- | ---------------------------------------------------------------------------- |
-| CLI Support    | Run `intlayer` commands, get usage hints and arguments inline                |
-| Versioned Docs | Auto-detect and load documentation matching your current version of Intlayer |
-| Autocompletion | Intelligent command and config suggestions as you type                       |
-| Plugin-Ready   | Compatible with IDEs and tools that support the MCP standard                 |
-
----
-
-##Useful Links
-
-- [Intlayer CLI Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
-- [Intlayer GitHub Repository](https://github.com/aymericzip/intlayer)
-
 ---
 
 ## Doc History
 
 | Version | Date       | Changes                              |
 | ------- | ---------- | ------------------------------------ |
-| 5.5.11  | 2025-07-10 | Add SSE transport and distant server |
+| 5.5.12  | 2025-07-11 | Add set up of ChatGPT                |
+| 5.5.12  | 2025-07-10 | Add set up of Claude Desktop         |
+| 5.5.12  | 2025-07-10 | Add SSE transport and distant server |
 | 5.5.10  | 2025-06-29 | Init history                         |

package/docs/en-GB/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -481,11 +481,9 @@ Settings that control how Intlayer optimises and builds your application's inter
 
 Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
 
-> In development mode, Intlayer uses a centralised static import for dictionaries to simplify the development experience.
+> In development mode, Intlayer uses static imports for dictionaries to simplify the development experience.
 
-> By optimising the build, Intlayer will replace all calls of dictionaries to optimise chunking. That way the final bundle will import only the dictionaries that are used.
-
-- **Note**: `@intlayer/babel` is available by default on `vite-intlayer` package, but `@intlayer/swc` is not installed by default on `next-intlayer` package as SWC plugins are still experimental on Next.js.
+> When optimised, Intlayer will replace dictionary calls to optimise chunking, so the final bundle only imports dictionaries that are actually used.
 
 #### Properties
 
@@ -495,21 +493,28 @@ Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Default_: `process.env.NODE_ENV === 'production'`
   - _Description_: Controls whether the build should be optimised.
   - _Example_: `true`
-  - _Note_: It will allow importing only the dictionaries that are used into the bundle. But all imports will remain as static imports to avoid async processing when loading the dictionaries.
-  - _Note_: When enabled, Intlayer will optimise dictionary chunking by replacing all calls of `useIntlayer` with `useDictionary` and `getIntlayer` with `getDictionary`.
+  - _Note_: When enabled, Intlayer will replace all calls of dictionaries to optimise chunking. That way the final bundle will import only the dictionaries that are used. All imports will stay as static import to avoid async processing when loading the dictionaries.
+  - _Note_: Intlayer will replace all calls of `useIntlayer` with the defined mode by the `importMode` option and `getIntlayer` with `getDictionary`.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Controls whether dictionary content should be dynamically imported per locale.
-  - _Example_: `true`
-  - _Note_: It will allow importing dynamically the dictionary content for the current locale only.
-  - _Note_: Dynamic imports rely on React Suspense and may slightly impact rendering performance. But if disabled all locales will be loaded at once, even if they are not used.
-  - _Note_: When enabled, Intlayer will optimise dictionary chunking by replacing all calls of `useIntlayer` with `useDynamicDictionary`.
-  - _Note_: This option will be ignored if `optimize` is disabled.
+- **importMode**:
+
+  - _Type_: `'static' | 'dynamic' | 'async'`
+  - _Default_: `'static'`
+  - _Description_: Controls how dictionaries are imported.
+  - _Example_: `'dynamic'`
+  - _Note_: Available modes:
+    - "static": Dictionaries are imported statically. Replaces `useIntlayer` with `useDictionary`.
+    - "dynamic": Dictionaries are imported dynamically using Suspense. Replaces `useIntlayer` with `useDictionaryDynamic`.
+    - "async": Dictionaries are imported dynamically asynchronously. Replaces `useIntlayer` with `await useDictionaryAsync`.
+  - _Note_: Dynamic imports rely on Suspense and may slightly impact rendering performance.
+  - _Note_: If disabled all locales will be loaded at once, even if they are not used.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
+  - _Note_: This option will be ignored if `optimize` is disabled.
+  - _Note_: In most cases, `"dynamic"` will be used for React applications, `"async"` for Vue.js applications.
+  - _Note_: This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions.
 
 - **traversePattern**:
   - _Type_: `string[]`

package/docs/en-GB/how_works_intlayer.md

@@ -103,7 +103,7 @@ The Babel and SWC plugins work by analysing your application's Abstract Syntax T
 
 In development mode, Intlayer uses a centralised static import for dictionaries to simplify the development experience.
 
-By activating the option `activateDynamicImport` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
+By activating the option `importMode = "dynamic"` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
 
 > `@intlayer/babel` is available by default on the `vite-intlayer` package,
 

package/docs/en-GB/intlayer_CMS.md

@@ -16,6 +16,7 @@ slugs:
   - doc
   - concept
   - cms
+youtubeVideo: https://www.youtube.com/watch?v=UDDTnirwi_4
 ---
 
 # Intlayer Content Management System (CMS) Documentation