Translate Flutter ARB files with Hyperlocalise

​

Source file

{
    "@@locale": "en-US",
    "welcome": "Welcome",
    "@welcome": {
        "description": "Home screen heading"
    }
}

​

Configure your files

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

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

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

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• Top-level message keys are translated. Keys beginning with @, including @@locale and @message objects, are metadata.
• Writeback preserves target metadata and carries source metadata forward for newly added messages.
• @@locale is updated to the target locale. Keep ICU placeholders and plural expressions in the message strings.

​

Next steps

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

​

Related formats

• JSON localization
• Android XML string resources
• Apple String Catalog (.xcstrings)