Translate YAML localization files with Hyperlocalise

​

Source file

home:
    title: Welcome
    steps:
        - Open your project
        - Start translating

​

Configure your files

locales:
    source: en-US
    targets:
        - es-ES

buckets:
    messages:
        files:
            - from: locales/en-US/messages.yaml
              to: locales/{{target}}/messages.yaml

llm:
    profiles:
        default:
            provider: openai
            model: gpt-5.2

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• The root must be a mapping. Nested mappings use dotted keys; sequences use indexed paths.
• Quote values that YAML could interpret as numbers, booleans, nulls, or timestamps. Non-string leaves, anchors, and aliases are rejected.
• Mapping keys cannot contain ., [ or ], which are reserved for flattened paths.
• Writeback preserves key order and comments where possible. Formatting and scalar styles may be normalized.

​

Next steps

• Check translations before committing generated files.
• Local translation workflow explains repeat runs.
• Browse all file formats.

​

Related formats

• JSON localization
• Java .properties