@intlayer/docs 7.2.3 → 7.3.0-canary.0

package/docs/en/intlayer_with_vite+svelte.md

@@ -81,7 +81,7 @@ bun add vite-intlayer --save-dev
 
 - **intlayer**
 
-  The core package that provides internationalization tools for configuration management, translation, [content declaration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), transpilation, and [CLI commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+  The core package that provides internationalization tools for configuration management, translation, [content declaration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), transpilation, and [CLI commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
 
 - **svelte-intlayer**
   The package that integrates Intlayer with Svelte application. It provides context providers and hooks for Svelte internationalization.

package/docs/en/intlayer_with_vite+vue.md

@@ -73,7 +73,7 @@ yarn add vite-intlayer --save-dev
 
 - **intlayer**
 
-  The core package that provides internationalization tools for configuration management, translation, [content declaration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), transpilation, and [CLI commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+  The core package that provides internationalization tools for configuration management, translation, [content declaration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), transpilation, and [CLI commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
 
 - **vue-intlayer**
   The package that integrates Intlayer with Vue application. It provides context providers and composables for Vue internationalization.

package/docs/en/introduction.md

@@ -148,7 +148,7 @@ Intlayer offers a variety of features tailored to meet the needs of modern web d
 - **Internationalization Support**: Enhance your application's global reach with built-in support for internationalization.
 - **Visual Editor**: Improve your development workflow with editor plugins designed for Intlayer. Check out the [Visual Editor Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md).
 - **Configuration Flexibility**: Customize your setup with extensive configuration options detailed in the [Configuration Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md).
-- **Advanced CLI Tools**: Manage your projects efficiently using Intlayer's command line interface. Explore the capabilities in the [CLI Tools Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md).
+- **Advanced CLI Tools**: Manage your projects efficiently using Intlayer's command line interface. Explore the capabilities in the [CLI Tools Documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
 
 ## Core Concepts
 

package/docs/en/mcp_server.md

@@ -49,7 +49,7 @@ By enabling the Intlayer MCP Server in your IDE, you unlock:
 - **Smart CLI Integration**
   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.
 
-  > 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).
+  > View the full list of commands and options in the [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
 
 ## Local server (stdio) vs Remote server (SSE)
 
@@ -163,7 +163,6 @@ Follow the [official documentation](https://platform.openai.com/docs/mcp#test-an
 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`

package/docs/en/per_locale_file.md

@@ -316,4 +316,4 @@ console.log(JSON.stringify(intlayer, null, 2));
 
 ### Automatic Translation Generation
 
-Use the [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md) to auto-fill missing translations based on your preferred services.
+Use the [intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) to auto-fill missing translations based on your preferred services.

package/docs/en/plugins/sync-json.md

@@ -326,7 +326,7 @@ The synchronized JSON files will be considered as other `.content` files. That m
 - `intlayer content push` to push the synchronized JSON files
 - `intlayer content pull` to pull the synchronized JSON files
 
-See [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md) for more details.
+See [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) for more details.
 
 ## Limitations (current)
 

package/docs/en/releases/v6.md

@@ -63,7 +63,7 @@ Total missing locales: 7
 Total missing required locales: 0
 ```
 
-See more options in the CLI docs: [CLI reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md) → "Test missing translations". As well as the [Testing](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/testing.md) guide.
+See more options in the CLI docs: [CLI reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) → "Test missing translations". As well as the [Testing](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/testing.md) guide.
 
 ---
 
@@ -297,7 +297,7 @@ Check the [migration notes from v6 to v7](https://github.com/aymericzip/intlayer
 
 ## Useful links
 
-- [CLI reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
+- [CLI reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md)
 - [Auto‑fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/autoFill.md)
 - [Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md)
 - [Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md)

package/docs/en/roadmap.md

@@ -286,7 +286,7 @@ Intlayer supports **TypeScript** (also JavaScript) and **JSON** for declaring co
 
 > Resources:
 >
-> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_cli.md)
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md)
 
 ---
 

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

@@ -0,0 +1,64 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Build Dictionaries
+description: Learn how to build your Intlayer dictionaries from content declaration files.
+keywords:
+  - Build
+  - Dictionaries
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - build
+---
+
+# Build Dictionaries
+
+To build your dictionaries, you can run the commands:
+
+```bash
+npx intlayer build
+```
+
+or in watch mode
+
+```bash
+npx intlayer build --watch
+```
+
+This command will find your declaration content files by default at `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}` and build the dictionaries in the `.intlayer` directory.
+
+## Aliases:
+
+- `npx intlayer dictionaries build`
+- `npx intlayer dictionary build`
+- `npx intlayer dic build`
+
+## Arguments:
+
+- **`--base-dir`**: Specify the base directory for the project. To retrieve the intlayer configuration, the command will look for the `intlayer.config.{ts,js,json,cjs,mjs}` file in the base directory.
+
+  > Example: `npx intlayer build --base-dir ./src`
+
+- **`--env`**: Specify the environment (e.g., `development`, `production`). Useful if you use environment variables in your intlayer configuration file.
+
+  > Example: `npx intlayer build --env production`
+
+- **`--env-file`**: Provide a custom environment file to load variables from. Useful if you use environment variables in your intlayer configuration file.
+
+  > Example: `npx intlayer build --env-file .env.production.local`
+
+- **`--with`**: Start a command in parallel with the build.
+
+  > Example: `npx intlayer build --with "next dev --turbopack"`
+
+- **`--skip-prepare`**: Skip the prepare step.
+
+  > Example: `npx intlayer build --skip-prepare`
+
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`

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

@@ -0,0 +1,63 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Manage Configuration
+description: Learn how to get and push your Intlayer configuration to the CMS.
+keywords:
+  - Configuration
+  - Config
+  - CLI
+  - Intlayer
+  - CMS
+slugs:
+  - doc
+  - concept
+  - cli
+  - configuration
+---
+
+# Manage Configuration
+
+## Get Configuration
+
+The `configuration get` command retrieves the current configuration for Intlayer, particularly the locale settings. This is useful for verifying your setup.
+
+```bash
+npx intlayer configuration get
+```
+
+## Aliases:
+
+- `npx intlayer config get`
+- `npx intlayer conf get`
+
+## Arguments:
+
+- **`--env`**: Specify the environment (e.g., `development`, `production`).
+- **`--env-file`**: Provide a custom environment file to load variables from.
+- **`--base-dir`**: Specify the base directory for the project.
+- **`--verbose`**: Enable verbose logging for debugging. (default to true using CLI)
+- **`--no-cache`**: Disable the cache.
+
+## Push Configuration
+
+The `configuration push` command uploads your configuration to the Intlayer CMS and editor. This step is necessary to enable the use of remote dictionaries in the Intlayer Visual Editor.
+
+```bash
+npx intlayer configuration push
+```
+
+## Aliases:
+
+- `npx intlayer config push`
+- `npx intlayer conf push`
+
+## Arguments:
+
+- **`--env`**: Specify the environment (e.g., `development`, `production`).
+- **`--env-file`**: Provide a custom environment file to load variables from.
+- **`--base-dir`**: Specify the base directory for the project.
+- **`--verbose`**: Enable verbose logging for debugging. (default to true using CLI)
+- **`--no-cache`**: Disable the cache.
+
+By pushing the configuration, your project is fully integrated with the Intlayer CMS, enabling seamless dictionary management across teams.

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

@@ -0,0 +1,46 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Debug Intlayer Command
+description: Learn how to debug and troubleshoot Intlayer CLI issues.
+keywords:
+  - Debug
+  - Troubleshoot
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - debug
+---
+
+# Debug intlayer command
+
+## 1. **Ensure you're using the latest version**
+
+Run:
+
+```bash
+npx intlayer --version                  # current locale intlayer version
+npx intlayer@latest --version           # current latest intlayer version
+```
+
+## 2. **Check if the command is registered**
+
+You can check with:
+
+```bash
+npx intlayer --help                     # Shows the list of available commands and usage information
+npx intlayer dictionary build --help    # Shows the list of available options for a command
+```
+
+## 3. **Restart your terminal**
+
+Sometimes a terminal restart is required to recognise new commands.
+
+## 4. **Clear npx cache (if you're stuck with an older version)**
+
+```bash
+npx clear-npx-cache
+```

package/docs/en-GB/cli/doc-review.md

@@ -0,0 +1,43 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Review Document
+description: Learn how to review documentation files for quality, consistency, and completeness across different locales.
+keywords:
+  - Review
+  - Document
+  - Documentation
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-review
+---
+
+# Review Document
+
+The `doc review` command analyses documentation files for quality, consistency, and completeness across different locales.
+
+```bash
+npx intlayer doc review
+```
+
+It can be used to review files that are already translated, and to check if the translation is correct.
+
+For most use cases,
+
+- prefer using the `doc translate` when the translated version of this file is not available.
+- prefer using the `doc review` when the translated version of this file already exists.
+
+> Note that the review process consumes more entry tokens than the translate process to review the same file entirely. However, the review process will optimise the chunks to review, and will skip the parts that are not changed.
+
+## Arguments:
+
+The `doc review` command accepts the same arguments as `doc translate`, allowing you to review specific documentation files and apply quality checks.
+
+If you have activated one of the git options, the command will only review the parts of the files that are being changed. The script will process by chunking the file and reviewing each chunk. If there are no changes in the chunk, the script will skip it to speed up the review process and limit the AI Provider API cost.
+
+For a complete list of arguments, see the [Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/cli/doc-translate.md) command documentation.

package/docs/en-GB/cli/doc-translate.md

@@ -0,0 +1,132 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Translate Document
+description: Learn how to automatically translate documentation files using AI translation services.
+keywords:
+  - Translate
+  - Document
+  - Documentation
+  - AI
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - doc-translate
+---
+
+# Translate Document
+
+The `doc translate` command automatically translates documentation files from a base locale to target locales using AI translation services.
+
+```bash
+npx intlayer doc translate
+```
+
+## Arguments:
+
+**File list options:**
+
+- **`--doc-pattern [docPattern...]`**: Glob patterns to match documentation files to translate.
+
+  > Example: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
+- **`--excluded-glob-pattern [excludedGlobPattern...]`**: Glob patterns to exclude from translation.
+
+  > Example: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: Skip the file if it has been modified before the specified time.
+  - Can be an absolute time such as "2025-12-05" (string or Date)
+  - Can be a relative time in ms `1 * 60 * 60 * 1000` (1 hour)
+  - This option checks the update time of the file using the `fs.stat` method. Therefore, it could be affected by Git or other tools that modify the file.
+
+  > Example: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: Skip the file if it has been modified within the specified time.
+  - Can be an absolute time such as "2025-12-05" (string or Date)
+  - Can be a relative time in ms `1 * 60 * 60 * 1000` (1 hour)
+  - This option checks the update time of the file using the `fs.stat` method. Therefore, it could be affected by Git or other tools that modify the file.
+
+  > Example: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+- **`--skip-if-exists`**: Skip the file if it already exists.
+
+  > Example: `npx intlayer doc translate --skip-if-exists`
+
+**Entry output options:**
+
+- **`--locales [locales...]`**: Target locales to translate the documentation into.
+
+  > Example: `npx intlayer doc translate --locales fr es de`
+
+- **`--base-locale [baseLocale]`**: Source locale to translate from.
+
+  > Example: `npx intlayer doc translate --base-locale en`
+
+**File processing options:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: Number of files to process simultaneously for translation.
+
+  > Example: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**AI options:**
+
+- **`--model [model]`**: The AI model to use for translation (e.g., `gpt-3.5-turbo`).
+- **`--provider [provider]`**: The AI provider to use for translation.
+- **`--temperature [temperature]`**: Temperature setting for the AI model.
+- **`--api-key [apiKey]`**: Provide your own API key for the AI service.
+- **`--application-context [applicationContext]`**: Provide additional context for the AI translation.
+- **`--custom-prompt [prompt]`**: Customise the base prompt used for translation. (Note: For most use cases, the `--custom-instructions` option is recommended instead as it provides better control over translation behaviour.)
+
+  > Example: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Environment variables options:**
+
+- **`--env`**: Specify the environment (e.g., `development`, `production`).
+- **`--env-file [envFile]`**: Provide a custom environment file to load variables from.
+- **`--base-dir`**: Specify the base directory for the project.
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
+
+**Log options:**
+
+- **`--verbose`**: Enable verbose logging for debugging. (defaults to true when using CLI)
+
+  > Example: `npx intlayer doc translate --verbose`
+
+**Custom instructions options:**
+
+- **`--custom-instructions [customInstructions]`**: Custom instructions added to the prompt. Useful for applying specific rules regarding formatting, URL translation, etc.
+  - Can be an absolute time such as "2025-12-05" (string or Date)
+  - Can be a relative time in ms `1 * 60 * 60 * 1000` (1 hour)
+  - This option checks the update time of the file using the `fs.stat` method. Therefore, it could be affected by Git or other tools that modify the file.
+
+  > Example: `npx intlayer doc translate --custom-instructions "Avoid translating URLs, and keep the markdown format"`
+
+  > Example: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**Git options:**
+
+- **`--git-diff`**: Only run on dictionaries that include changes from the base (default `origin/main`) to the current branch (default: `HEAD`).
+- **`--git-diff-base`**: Specify the base reference for git diff (default `origin/main`).
+- **`--git-diff-current`**: Specify the current reference for git diff (default: `HEAD`).
+- **`--uncommitted`**: Include uncommitted changes.
+- **`--unpushed`**: Include unpushed changes.
+- **`--untracked`**: Include untracked files.
+
+  > Example: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Example: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+> Note that the output file path will be determined by replacing the following patterns
+>
+> - `/{{baseLocale}}/` with `/{{locale}}/` (Unix)
+> - `\{{baseLocale}}\` with `\{{locale}}\` (Windows)
+> - `_{{baseLocale}}.` with `_{{locale}}.`
+> - `{{baseLocale}}_` with `{{locale}}_`
+> - `.{{baseLocaleName}}.` with `.{{localeName}}.`
+>
+> If the pattern is not found, the output file will add `.{{locale}}` to the file extension. For example, `./my/file.md` will be translated to `./my/file.fr.md` for the French locale.

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

@@ -0,0 +1,28 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Editor Commands
+description: Learn how to use the Intlayer editor commands.
+keywords:
+  - Editor
+  - Visual Editor
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - editor
+---
+
+# Editor commands
+
+The `editor` command wraps the `intlayer-editor` commands.
+
+> To be able to use the `editor` command, the `intlayer-editor` package must be installed. (See [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/intlayer_visual_editor.md))
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:editor:start": "npx intlayer editor start --with 'next dev --turbopack'"
+}
+```

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

@@ -0,0 +1,130 @@
+---
+createdAt: 2024-08-11
+updatedAt: 2025-11-22
+title: Fill Dictionaries
+description: Learn how to fill, audit, and translate your dictionaries using AI.
+keywords:
+  - Fill
+  - Audit
+  - Translate
+  - Dictionaries
+  - CLI
+  - Intlayer
+  - AI
+slugs:
+  - doc
+  - concept
+  - cli
+  - fill
+---
+
+# Fill / audit / translate dictionaries
+
+```bash
+npx intlayer fill
+```
+
+This command analyses your content declaration files for potential issues such as missing translations, structural inconsistencies, or type mismatches. If it finds any problems, **intlayer fill** will propose or apply updates to keep your dictionaries consistent and complete.
+
+## Aliases:
+
+- `npx intlayer dictionaries fill`
+- `npx intlayer dictionary fill`
+- `npx intlayer dic fill`
+
+## Arguments:
+
+**Files list options:**
+
+- **`-f, --file [files...]`**: A list of specific content declaration files to audit. If not provided, all discovered `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` based on your configuration file setup will be audited.
+
+  > Example: `npx intlayer dictionary fill -f src/home/app.content.ts`
+
+- **`-k, --keys [keys...]`**: Filter dictionaries based on keys. If not provided, all dictionaries will be audited.
+
+  > Example: `npx intlayer dictionary fill -k key1 key2`
+
+- **`--key [keys...]`**: Filter dictionaries based on keys (alias for --keys).
+
+  > Example: `npx intlayer dictionary fill --key key1 key2`
+
+- **`--excluded-keys [excludedKeys...]`**: Filter out dictionaries based on keys. If not provided, all dictionaries will be audited.
+
+  > Example: `npx intlayer dictionary fill --excluded-keys key1 key2`
+
+- **`--excluded-key [excludedKeys...]`**: Filter out dictionaries based on keys (alias for --excluded-keys).
+
+  > Example: `npx intlayer dictionary fill --excluded-key key1 key2`
+
+- **`--path-filter [pathFilters...]`**: Filter dictionaries based on glob pattern for file paths.
+
+  > Example: `npx intlayer dictionary fill --path-filter "src/home/**"`
+
+**Entry output options:**
+
+- **`--source-locale [sourceLocale]`**: The source locale to translate from. If not specified, the default locale from your configuration will be used.
+
+- **`--output-locales [outputLocales...]`**: Target locales to translate to. If not specified, all locales from your configuration will be used except the source locale.
+
+- **`--mode [mode]`**: Translation mode: `complete`, `review`. Default is `complete`. `complete` will fill all missing content, `review` will fill missing content and review existing keys.
+
+**Git options:**
+
+- **`--git-diff`**: Only run on dictionaries that include changes from base (default `origin/main`) to current branch (default: `HEAD`).
+- **`--git-diff-base`**: Specify the base reference for git diff (default `origin/main`).
+- **`--git-diff-current`**: Specify the current reference for git diff (default: `HEAD`).
+- **`--uncommitted`**: Include uncommitted changes.
+- **`--unpushed`**: Include unpushed changes.
+- **`--untracked`**: Include untracked files.
+
+  > Example: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > Example: `npx intlayer doc translate --uncommitted --unpushed --untracked`
+
+**AI options:**
+
+- **`--model [model]`**: The AI model to use for the translation (e.g., `gpt-3.5-turbo`).
+- **`--provider [provider]`**: The AI provider to use for the translation.
+- **`--temperature [temperature]`**: Temperature setting for the AI model.
+- **`--api-key [apiKey]`**: Provide your own API key for the AI service.
+- **`--custom-prompt [prompt]`**: Provide a custom prompt for your translation instructions.
+- **`--application-context [applicationContext]`**: Provide additional context for the AI translation.
+
+  > Example: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"`
+
+**Environment variables options:**
+
+- **`--env`**: Specify the environment (e.g., `development`, `production`).
+- **`--env-file [envFile]`**: Provide a custom environment file to load variables from.
+
+  > Example: `npx intlayer fill --env-file .env.production.local`
+
+  > Example: `npx intlayer fill --env production`
+
+**Configuration options:**
+
+- **`--base-dir`**: Specify the base directory for the project.
+
+  > Example: `npx intlayer fill --base-dir ./src`
+
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
+**Preparation options:**
+
+- **`--build`**: Build the dictionaries before pushing to ensure the content is up to date. True will force the build, false will skip the build, undefined will allow using the cache of the build.
+
+- **`--skip-metadata`**: Skip filling in missing metadata (description, title, tags) for dictionaries.
+
+**Log options:**
+
+- **`--verbose`**: Enable verbose logging for debugging. (defaults to true when using CLI)
+
+## Example:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+This command will translate content from English to French and Spanish for all content declaration files in the `src/home/` directory using the GPT-3.5 Turbo model.