Skip to main content

​
Minimal layout

apps
web
lang
es-ES.json
lab
packages
ui
lang
en-US.json
i18n.yml

​
Minimal config pattern

Use one bucket to start:
  • locales.source: your source locale (for example en-US)
  • locales.targets: one target locale (for example es-ES)
  • buckets.ui.files: map source path template to target path template
  • llm.profiles.default: choose your provider and model
For full fields, see i18n config. In this setup, translations are sourced from packages/ui/lang and generated into apps/web/lang. If you omit groups, Hyperlocalise automatically runs every configured bucket for every target locale.

​
Generated artifacts

After hyperlocalise run:
  • translated target files under your configured to paths
  • .hyperlocalise.lock.json in project root
  • sidecar metadata files for provenance, depending on your store layout