intlayer-config

Intlayer Configuration

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.

Supported configuration files:

• intlayer.config.{ts|js|cjs|mjs|json|json5|jsonc}
• .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.

Retrieving configuration into your app

import { defaultLocale, getConfiguration, locales } from "intlayer";

console.log(locales); // ['en', 'fr', ...]
console.log(defaultLocale); // 'en'

// Other sections: internationalization, routing, editor, content, log
const { routing } = getConfiguration();

console.log(routing.mode); // 'prefix-no-default'

References

• Website
• Doc

Concepts

• Configuration