Skip to main content

Top-level keys

  • locales
  • buckets
  • groups
  • llm
  • storage (required for sync)

locales

  • source (string, required)
  • targets (string array, required)
  • fallbacks (object, optional)

buckets

  • map of bucket name -> bucket definition
  • files array with from and to templates

groups

  • map of group name -> group definition
  • targets array
  • buckets array

llm

  • profiles map of profile name -> provider/model/prompt
  • supported providers: openai | azure_openai | anthropic | gemini | bedrock | lmstudio | groq | ollama
  • rules array with priority, group, profile

storage

  • adapter: poeditor | lilt | lokalise | crowdin | phrase | smartling
  • config: adapter-specific fields
For examples, see i18n config.

CSV workflow note

Use buckets.*.files[].from and to to point at .csv files when you run CSV-based localization flows.
  • Per-locale files typically use [locale] in the to path.
  • Shared CSV files can reuse the same from and to path.