v8.1.2 to git:20260218.9e3308f

51 added, 11 removed. Audit A to A.

---

name: intlayer-config

description: Configures Intlayer project settings and environment variables. Use when the user asks to "setup intlayer.config", "configure locales", or "customize Intlayer settings".

metadata:

- author: Intlayer

- url: https://intlayer.org

- license: Apache-2.0

- mcp-server: @intlayer/mcp

- category: productivity

- tags: [i18n]

- documentation: https://intlayer.org/doc

- support: contact@intlayer.org

- version: 8.1.2

+ author: Intlayer

+ url: https://intlayer.org

+ license: Apache-2.0

+ mcp-server: "@intlayer/mcp"

+ category: productivity

+ tags: [i18n]

+ documentation: https://intlayer.org/doc

+ support: contact@intlayer.org

---

# Intlayer Configuration

- Understand how to configure Intlayer:

+ Configure Intlayer project settings and environment variables. Check these files to identify which locales are declared for the application, which helps in defining the appropriate content.

- - [Configuration](https://intlayer.org/doc/concept/configuration.md)

+ Supported configuration files:

+ - `intlayer.config.{ts|js|json|json5|jsonc|cjs|mjs}`

+ - `.intlayerrc`

+ It acts as the central brain for your application's internationalization strategy. It is divided into several specialized sections that control everything from language support to AI-powered translations.

+ ### Internationalization

+ This section defines your language footprint.

+ - **Locales**: Define which languages you support (e.g., English, French, Spanish).

+ - **Default Locale**: Set the fallback language if a user's preference isn't found.

+ ### Routing & middleware

+ Controls how users navigate between different languages.

+ ### AI & Automation

+ Intlayer integrates with major AI providers (OpenAI, Anthropic, Gemini, etc.) to automate your workflow.

+ ### Content & Dictionaries

+ Manages how and where your translation files are handled.

+ - **Import Mode**: Choose between **Static** (faster performance), **Dynamic** (lazy loading), or **Fetch** (live updates from a CMS).

+ - **Auto-Transformation**: Automatically convert Markdown or HTML strings into processed components.

+ ### Editor & System

+ Settings for the visual workflow and internal plumbing.

+ ## References

+ ### Concepts

+ - [Configuration](references/concept_configuration.md)

+ ### Packages

+ - [Intlayer getConfiguration](references/packages_intlayer_getConfiguration.md)