@intlayer/docs 8.6.0 → 8.6.10

package/docs/en-GB/cli/index.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2026-01-06
-title: CLI
-description: Discover how to use the Intlayer CLI to manage your multilingual website. Follow the steps in this online documentation to set up your project in a few minutes.
+updatedAt: 2026-03-31
+title: CLI - All Intlayer CLI commands for your multilingual website
+description: Discover how to use the Intlayer CLI to manage your multilingual website. Follow the steps in this online documentation to set up your project in minutes.
 keywords:
   - CLI
   - Command Line Interface
@@ -17,48 +17,54 @@ slugs:
   - concept
   - cli
 history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "Added standalone command content"
   - version: 7.5.11
     date: 2026-01-06
-    changes: "Add projects list command"
+    changes: "Added CI command content"
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: "Added list projects command content"
   - version: 7.5.9
     date: 2025-12-30
-    changes: "Add init command"
+    changes: "Added init command content"
   - version: 7.2.3
     date: 2025-11-22
-    changes: "Add transform command"
+    changes: "Added extract command content"
   - version: 7.1.0
     date: 2025-11-05
-    changes: "Add skipIfExists option to translate command"
+    changes: "Added skipIfExists option to translate command"
   - version: 6.1.4
     date: 2025-01-27
-    changes: "Add aliases for CLI arguments and commands"
+    changes: "Added aliases for CLI arguments and commands"
   - version: 6.1.3
     date: 2025-10-05
-    changes: "Add build option to commands"
+    changes: "Added build option to commands"
   - version: 6.1.2
     date: 2025-09-26
-    changes: "Add version command"
+    changes: "Added version command content"
   - version: 6.1.0
     date: 2025-09-26
-    changes: "Set verbose option to default to true using CLI"
+    changes: "Set verbose option to true by default via CLI"
   - version: 6.1.0
     date: 2025-09-23
-    changes: "Add watch command and with option"
+    changes: "Added watch command and with option"
   - version: 6.0.1
     date: 2025-09-23
-    changes: "Add editor command"
+    changes: "Added editor command content"
   - version: 6.0.0
     date: 2025-09-17
-    changes: "Add content test and list command"
+    changes: "Added content test and list commands"
   - version: 5.5.11
     date: 2025-07-11
-    changes: "Update CLI command parameters documentation"
+    changes: "Updated documentation for CLI command parameters"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Init history"
 ---
 
-# Intlayer CLI
+# Intlayer CLI - All Intlayer CLI commands for your multilingual website
 
 ---
 
@@ -68,7 +74,7 @@ history:
 
 ---
 
-## Install Package
+## Installing the package
 
 Install the necessary packages using npm:
 
@@ -90,17 +96,17 @@ bun add intlayer-cli -g
 
 > If the `intlayer` package is already installed, the CLI is automatically installed. You can skip this step.
 
-## intlayer-cli package
+## The intlayer-cli package
 
-The `intlayer-cli` package is intended to transpile your [intlayer declarations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/dictionary/content_file.md) into dictionaries.
+The `intlayer-cli` package is designed to transpile your [Intlayer declarations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/dictionary/content_file.md) into dictionaries.
 
-This package will transpile all intlayer files, such as `src/**/*.content.{ts|js|mjs|cjs|json}`. [See how to declare your Intlayer declaration files](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+This package transpiles all Intlayer files, such as `src/**/*.content.{ts|js|mjs|cjs|json}`. [See how to declare your Intlayer declaration files](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
-To interpret intlayer dictionaries you can use interpreters, such as [react-intlayer](https://www.npmjs.com/package/react-intlayer), or [next-intlayer](https://www.npmjs.com/package/next-intlayer)
+To interpret the Intlayer dictionaries, you can use interpreters, such as [react-intlayer](https://www.npmjs.com/package/react-intlayer) or [next-intlayer](https://www.npmjs.com/package/next-intlayer).
 
-## Configuration File Support
+## Config file support
 
-Intlayer accepts multiple configuration file formats:
+Intlayer accepts several configuration file formats:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -109,54 +115,59 @@ Intlayer accepts multiple configuration file formats:
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-To see how to configure available locales, or other parameters, refer to the [configuration documentation here](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md).
+To learn how to configure the available languages or other parameters, take a look at the [configuration documentation here](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md).
 
-## Run intlayer commands
+## Executing Intlayer commands
 
 ### Authentication
 
-- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/login.md)** - Authenticate with the Intlayer CMS and get access credentials
+- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/login.md)** - Authenticate with the Intlayer CMS and get the access credentials
 
 ### Core Commands
 
-- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/build.md)** - Build your dictionaries from content declaration files
-- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/watch.md)** - Watch for changes and automatically build dictionaries
+- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/build.md)** - Build your dictionaries from your content declaration files
+- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/watch.md)** - Watch for changes and automatically rebuild dictionaries
+- **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/standalone.md)** - Create a standalone JavaScript bundle containing Intlayer and specified packages.
 - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/version.md)** - Check the installed Intlayer CLI version
 - **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/list_projects.md)** - List all Intlayer projects in a directory or git repository
 
 ### Dictionary Management
 
-- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/push.md)** - Push dictionaries to the Intlayer editor and CMS
-- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/pull.md)** - Pull dictionaries from the Intlayer editor and CMS
+- **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/push.md)** - Push the dictionaries to the Intlayer Editor and CMS
+- **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/pull.md)** - Pull the dictionaries from the Intlayer Editor and CMS
 - **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/fill.md)** - Fill, audit, and translate dictionaries using AI
 - **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/test.md)** - Test and identify missing translations
 - **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/list.md)** - List all content declaration files in your project
 
 ### Component Management
 
-- **[Transform Components](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/extract.md)** - Transform existing components to use Intlayer
+- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/extract.md)** - Extract strings from components into a .content file near the component
 
 ### Configuration
 
 - **[Initialise Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/init.md)** - Set up Intlayer in your project with automatic configuration
-- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/configuration.md)** - Get and push your Intlayer configuration to the CMS
+- **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/configuration.md)** - Get your Intlayer configuration and push it to the CMS
+
+### Doc Management
+
+- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/doc-translate.md)** - Automatically translate document files using AI
+- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/doc-review.md)** - Review document files for quality and consistency
 
-### Documentation Management
+### Editor and Live Sync
 
-- **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/doc-translate.md)** - Automatically translate documentation files using AI
-- **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/doc-review.md)** - Review documentation files for quality and consistency
+- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/editor.md)** - Use the Intlayer Editor commands
+- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/live.md)** - Use Live Sync to apply content changes from CMS in real time
 
-### Editor & Live Sync
+### CI/CD and Automation
 
-- **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/editor.md)** - Use the Intlayer editor commands
-- **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/live.md)** - Use Live Sync to reflect CMS content changes at runtime
+- **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/ci.md)** - Execute Intlayer commands with automatically injected credentials for CI/CD flows
 
-### Development Tools
+### Developer Tools
 
 - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/sdk.md)** - Use the Intlayer CLI SDK in your own code
-- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/debug.md)** - Debug and troubleshoot Intlayer CLI issues
+- **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/debug.md)** - Debug and resolve issues with the Intlayer CLI
 
-## Use intlayer commands in your `package.json`
+## Use the intlayer commands in your `package.json` file
 
 ```json fileName="package.json"
 "scripts": {
@@ -164,6 +175,7 @@ To see how to configure available locales, or other parameters, refer to the [co
   "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
+  "intlayer:standalone": "npx intlayer standalone --packages intlayer vanilla-intlayer",
   "intlayer:push": "npx intlayer push",
   "intlayer:pull": "npx intlayer pull",
   "intlayer:fill": "npx intlayer fill",
@@ -178,6 +190,6 @@ To see how to configure available locales, or other parameters, refer to the [co
 
 > **Note**: You can also use the shorter aliases:
 >
-> - `npx intlayer list` instead of `npx intlayer content list`
-> - `npx intlayer test` instead of `npx intlayer content test`
-> - `npx intlayer projects-list` or `npx intlayer pl` instead of `npx intlayer projects list`
+> - `npx intlayer list`: replaces `npx intlayer content list`
+> - `npx intlayer test`: replaces `npx intlayer content test`
+> - `npx intlayer projects-list` or `npx intlayer pl`: replaces `npx intlayer projects list`

package/docs/en-GB/cli/init.md

@@ -14,9 +14,12 @@ slugs:
   - cli
   - init
 history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "Added --no-gitignore option"
   - version: 7.5.9
     date: 2025-12-30
-    changes: "Add init command"
+    changes: "Added init command content"
 ---
 
 # Initialise Intlayer
@@ -25,7 +28,7 @@ history:
 npx intlayer init
 ```
 
-The `init` command automatically sets up Intlayer in your project by configuring the necessary files and settings. It's the recommended way to get started with Intlayer.
+The `init` command automatically configures Intlayer for your project by creating necessary files and settings. This is the recommended way to start with Intlayer.
 
 ## Aliases:
 
@@ -33,18 +36,19 @@ The `init` command automatically sets up Intlayer in your project by configuring
 
 ## Arguments:
 
-- `--project-root [projectRoot]` - Optional. Specify the project root directory. If not provided, the command will search for the project root starting from the current working directory.
+- `--project-root [projectRoot]` - Optional. Specify the project's root directory. If not provided, the command will search for the project root starting from the current working directory.
+- `--no-gitignore` - Optional. Skips the automatic update of the `.gitignore` file. If this flag is set, `.intlayer` will not be added to `.gitignore`.
 
 ## What it does:
 
 The `init` command performs the following setup tasks:
 
-1. **Validates project structure** - Ensures you are in a valid project directory containing a `package.json` file
-2. **Updates `.gitignore`** - Adds `.intlayer` to your `.gitignore` file to exclude generated files from version control
-3. **Configures TypeScript** - Updates all `tsconfig.json` files to include Intlayer type definitions (`.intlayer/**/*.ts`)
-4. **Creates configuration file** - Generates an `intlayer.config.ts` (for TypeScript projects) or `intlayer.config.mjs` (for JavaScript projects) with default settings
-5. **Updates Vite config** - If a Vite configuration file is detected, adds the `vite-intlayer` plugin import
-6. **Updates Next.js config** - If a Next.js configuration file is detected, adds the `next-intlayer` plugin import
+1. **Validates project structure** - Ensures you are in a valid project directory with a `package.json` file.
+2. **Updates `.gitignore`** - Adds `.intlayer` to your `.gitignore` file to exclude generated files from version control (can be skipped with `--no-gitignore`).
+3. **Configures TypeScript** - Updates any `tsconfig.json` files to include the Intlayer type definitions (`.intlayer/**/*.ts`).
+4. **Creates configuration file** - Generates `intlayer.config.ts` (for TypeScript projects) or `intlayer.config.mjs` (for JavaScript projects) with default settings.
+5. **Updates Vite configuration** - If a Vite config file is detected, it adds the import for the `vite-intlayer` plugin.
+6. **Updates Next.js configuration** - If a Next.js config file is detected, it adds the import for the `next-intlayer` plugin.
 
 ## Examples:
 
@@ -54,17 +58,25 @@ The `init` command performs the following setup tasks:
 npx intlayer init
 ```
 
-This will initialise Intlayer in the current directory, automatically detecting the project root.
+This initialises Intlayer in the current directory, with automatic project root detection.
 
-### Initialise with custom project root:
+### Initialisation with a custom project root:
 
 ```bash
 npx intlayer init --project-root ./my-project
 ```
 
-This will initialise Intlayer in the specified directory.
+This initialises Intlayer in the specified directory.
 
-## Example output:
+### Initialisation without updating .gitignore:
+
+```bash
+npx intlayer init --no-gitignore
+```
+
+This will set up all configuration files but will not modify your `.gitignore` file.
+
+## Output Example:
 
 ```bash
 npx intlayer init
@@ -78,12 +90,7 @@ Checking Intlayer configuration...
 
 ## Notes:
 
-- The command is idempotent, you can run it multiple times safely. It will skip steps that are already configured.
-- If a configuration file already exists, it will not be overwritten.
-- TypeScript config files without an `include` array (e.g., solution-style configs with references) are skipped.
-- The command will exit with an error if no `package.json` is found in the project root.
-
-- The command is idempotent - you can run it multiple times safely. It will skip steps that are already configured.
+- The command is idempotent — you can safely run it multiple times. Already configured steps will be automatically skipped.
 - If a configuration file already exists, it will not be overwritten.
-- TypeScript config files without an `include` array (e.g., solution-style configs with references) are skipped.
-- The command will exit with an error if no `package.json` is found in the project root.
+- TypeScript configurations without an `include` array (e.g. solution-style configurations with references) are skipped.
+- The command stops with an error if no `package.json` is found in the project root.

package/docs/en-GB/cli/standalone.md

@@ -0,0 +1,91 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2026-03-31
+title: Standalone Bundle
+description: Learn how to create a standalone JavaScript bundle for app content.
+keywords:
+  - Standalone
+  - Bundle
+  - CLI
+  - Intlayer
+  - Editor
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - standalone
+history:
+  - version: 8.6.4
+    date: 2026-03-31
+    changes: "Init standalone command documentation"
+---
+
+# Standalone Bundle
+
+The `standalone` command allows you to create a standalone JavaScript bundle containing Intlayer and any other specified packages. This is particularly useful for using Intlayer in environments without a package manager or a bundler, such as a simple HTML/JS app.
+
+The bundle uses [esbuild](https://esbuild.github.io/) to combine the requested packages and their dependencies into a single file that can be easily imported into any web project.
+
+## Usage
+
+```bash
+npx intlayer standalone --packages [packages...] [options]
+```
+
+## Options
+
+- `-o, --outfile [outfile]` - Optional. The name of the output file. Default: `intlayer-bundle.js`.
+- `--packages [packages...]` - Required. List of packages to include in the bundle (e.g. `intlayer`, `vanilla-intlayer`).
+- `--version [version]` - Optional. The version of the packages to bundle. If not specified, the Intlayer CLI version is used by default.
+- `--minify` - Optional. Whether to minify the output. Default: `true`.
+- `--platform [platform]` - Optional. Target platform for the bundle (e.g. `browser`, `node`). Default: `browser`.
+- `--format [format]` - Optional. Output format for the bundle (e.g. `esm`, `cjs`, `iife`). Default: `esm`.
+
+## General Options
+
+- `--env-file [envFile]` - Environment file.
+- `-e, --env [env]` - Environment.
+- `--base-dir [baseDir]` - Base directory.
+- `--no-cache` - Disable cache.
+- `--verbose` - Verbose output.
+
+## Examples:
+
+### Create a bundle for Vanilla JS:
+
+```bash
+npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js
+```
+
+This will create an `intlayer.js` file containing both `intlayer` and `vanilla-intlayer` packages, minified and in ESM format, ready to be used in the browser via a `<script>` tag.
+
+### Bundle a specific version:
+
+```bash
+npx intlayer standalone --packages intlayer --version 8.6.4
+```
+
+### Bundle in a different format:
+
+```bash
+npx intlayer standalone --packages intlayer --format iife
+```
+
+## What it does:
+
+1. **Creates a temporary environment** - Sets up a temporary directory to manage dependencies.
+2. **Installs packages** - Uses `npm` or `bun` (if available) to install the requested packages and their dependencies.
+3. **Generates an entry point** - Creates a temporary entry point file that exports all requested packages and exposes them as global variables when running in the browser.
+4. **Bundles with esbuild** - Uses esbuild to combine everything into a single file, applying minification and formatting as requested.
+5. **Generates the file** - Writes the resulting bundle to the specified output path.
+
+## Global Variables
+
+When the bundle is loaded in the browser, it exposes the requested packages as global variables on the `window` object. Variable names are derived from the package names (e.g. `intlayer` becomes `Intlayer`, and `vanilla-intlayer` becomes `VanillaIntlayer`).
+
+```javascript
+// Accessing Intlayer from the bundle
+const { getLocaleName } = window.Intlayer;
+const { installIntlayer, useIntlayer } = window.VanillaIntlayer;
+```

package/docs/en-GB/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-03-12
+updatedAt: 2026-04-08
 title: Configuration
 description: Learn how to configure Intlayer for your application. Understand the various settings and options available to customize Intlayer to your needs.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 8.7.0
+    date: 2026-04-08
+    changes: "Add `prune` and `minify` options to the build configuration"
+  - version: 8.7.0
+    date: 2026-04-03
+    changes: "Add `currentDomain` option"
   - version: 8.4.0
     date: 2026-03-20
     changes: "Add object per-locale notation for 'compiler.output' and 'dictionary.fill'"
@@ -237,6 +243,17 @@ const config: IntlayerConfig = {
         fr: "/[locale]/a-propos",
       },
     }),
+
+    /**
+     * Maps locales to domain hostnames for domain-based routing.
+     * URLs for these locales will be absolute (e.g., https://intlayer.cn/).
+     * The domain implies the locale, so no locale prefix is added to the path.
+     * Default: undefined
+     */
+    domains: {
+      en: "intlayer.org",
+      zh: "intlayer.cn",
+    },
   },
 
   /**
@@ -388,6 +405,25 @@ const config: IntlayerConfig = {
      */
     optimize: true,
 
+    /**
+     * Minify the dictionaries to reduce the bundle size.
+     * Default: false
+     *
+     * Note:
+     * - This option will be ignored if `optimize` is disabled.
+     * - This option will be ignored if `editor.enabled` is true.
+     */
+    minify: true,
+
+    /**
+     * Purge the unused keys in a dictionaries.
+     * Default: false
+     *
+     * Note:
+     * - This option will be ignored if `optimize` is disabled.
+     */
+    purge: true,
+
     /**
      * Output format for generated dictionary files.
      * Default: ['cjs', 'esm']
@@ -598,12 +634,13 @@ Defines settings related to the integrated editor, including server port and act
 
 Settings that control routing behavior, including URL structure, locale storage, and middleware handling.
 
-| Field      | Description                                                                                                                  | Type                                                                                                                                                                                                         | Default                | Example                                                                                                                                                                                     | Note                                                                                                                                                                                                                                                                   |
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`     | URL routing mode for locale handling.                                                                                        | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) or `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale handled via other means. `'search-params'`: `/dashboard?locale=fr` | Does not impact cookie or locale storage management.                                                                                                                                                                                                                   |
-| `storage`  | Configuration for storing the locale in the client.                                                                          | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                          | See Storage Options table below.                                                                                                                                                                                                                                       |
-| `basePath` | The base path for the application URLs.                                                                                      | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                 | If app is at `https://example.com/my-app, basePath is `'/my-app'`and URLs become`https://example.com/my-app/en`.                                                                                                                                                       |
-| `rewrite`  | Custom URL rewriting rules that override the default routing mode for specific paths. Supports `[param]` dynamic parameters. | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | See example below                                                                                                                                                                           | • Rewrite rules take precedence over `mode`.<br/>• Works with Next.js and Vite.<br/>• `getLocalizedUrl()` automatically applies matching rules.<br/>• See [Custom URL Rewrites](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
+| Field      | Description                                                                                                                                                                   | Type                                                                                                                                                                                                         | Default                | Example                                                                                                                                                                                     | Note                                                                                                                                                                                                                                                                   |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | URL routing mode for locale handling.                                                                                                                                         | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (en) or `/fr/dashboard` (fr). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: locale handled via other means. `'search-params'`: `/dashboard?locale=fr` | Does not impact cookie or locale storage management.                                                                                                                                                                                                                   |
+| `storage`  | Configuration for storing the locale in the client.                                                                                                                           | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                          | See Storage Options table below.                                                                                                                                                                                                                                       |
+| `basePath` | The base path for the application URLs.                                                                                                                                       | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                 | If app is at `https://example.com/my-app, basePath is `'/my-app'`and URLs become`https://example.com/my-app/en`.                                                                                                                                                       |
+| `rewrite`  | Custom URL rewriting rules that override the default routing mode for specific paths. Supports `[param]` dynamic parameters.                                                  | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | See example below                                                                                                                                                                           | • Rewrite rules take precedence over `mode`.<br/>• Works with Next.js and Vite.<br/>• `getLocalizedUrl()` automatically applies matching rules.<br/>• See [Custom URL Rewrites](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
+| `domains`  | Maps locales to domain hostnames for domain-based routing. When set, URLs for that locale use this domain as a base (absolute URL) and no locale prefix is added to the path. | `Partial<Record<Locale, string>>`                                                                                                                                                                            | `undefined`            | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }`                                                                                                                                                 | • Default protocol is `https://` if not included in the hostname.<br/>• The domain itself identifies the locale, so no `/zh/` prefix is added.<br/>• `getLocalizedUrl('/', 'zh')` returns `https://intlayer.zh/`.                                                      |
 
 **`rewrite` example**:
 
@@ -922,13 +959,15 @@ Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
 
 > When optimized, Intlayer will replace dictionary calls to optimize chunking, so the final bundle only imports dictionaries that are actually used.
 
-| Field             | Description                                                          | Type                             | Default                                                                                                                                                                           | Example                                                                       | Note                                                                                                                                                                                                                                                                                                                                                                      |
-| ----------------- | -------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | Controls the mode of the build.                                      | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: build enabled automatically when the application is built.<br/>• `'manual'`: only runs when the build command is executed.<br/>• Can be used to disable dictionary builds (e.g. to avoid running in Node.js environments).                                                                                                                                    |
-| `optimize`        | Controls whether the build should be optimized.                      | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • If unset, optimization is triggered on framework build (Vite/Next.js).<br/>• `true` forces optimization including dev mode.<br/>• `false` disables it.<br/>• When enabled, replaces dictionary calls to optimize chunking — only used dictionaries are imported.<br/>• Relies on `@intlayer/babel` and `@intlayer/swc` plugins.<br/>• Keys must be declared statically. |
-| `checkTypes`      | Indicates if the build should check TypeScript types and log errors. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Can slow down the build.                                                                                                                                                                                                                                                                                                                                                  |
-| `outputFormat`    | Controls the output format of the dictionaries.                      | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                           |
-| `traversePattern` | Patterns defining which files to traverse during optimization.       | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limit optimization to relevant files to improve build performance.<br/>• Ignored if `optimize` is disabled.<br/>• Uses glob pattern.                                                                                                                                                                                                                                    |
+| Field             | Description                                                               | Type                             | Default                                                                                                                                                                           | Example                                                                       | Note                                                                                                                                                                                                                                                                                                                                                                      |
+| ----------------- | ------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`            | Controls the mode of the build.                                           | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: build enabled automatically when the application is built.<br/>• `'manual'`: only runs when the build command is executed.<br/>• Can be used to disable dictionary builds (e.g. to avoid running in Node.js environments).                                                                                                                                    |
+| `optimize`        | Controls whether the build should be optimized.                           | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • If unset, optimization is triggered on framework build (Vite/Next.js).<br/>• `true` forces optimization including dev mode.<br/>• `false` disables it.<br/>• When enabled, replaces dictionary calls to optimize chunking — only used dictionaries are imported.<br/>• Relies on `@intlayer/babel` and `@intlayer/swc` plugins.<br/>• Keys must be declared statically. |
+| `minify`          | Defines if the dictionaries should be minified to reduce the bundle size. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • Defines if the bundle should be minified.<br/>• Default: `false` in production.<br/>• This option will be ignored if `optimize` is disabled.<br/>• This option will be ignored if `editor.enabled` is true.                                                                                                                                                             |
+| `prune`           | Defines if the unused keys in dictionaries should be purged.              | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • Defines if the bundle should be pruned.<br/>• Default: `true` in production.<br/>• This option will be ignored if `optimize` is disabled.                                                                                                                                                                                                                               |
+| `checkTypes`      | Indicates if the build should check TypeScript types and log errors.      | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | Can slow down the build.                                                                                                                                                                                                                                                                                                                                                  |
+| `outputFormat`    | Controls the output format of the dictionaries.                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                           |
+| `traversePattern` | Patterns defining which files to traverse during optimization.            | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • Limit optimization to relevant files to improve build performance.<br/>• Ignored if `optimize` is disabled.<br/>• Uses glob pattern.                                                                                                                                                                                                                                    |
 
 ---