Skip to main content
Apple .strings files store keyed messages for iOS and macOS applications. Hyperlocalise translates message values; use the separate stringsdict guide when your localization includes plural resources. Supported extensions: .strings.

Source file

Save this example as locales/en-US.lproj/Localizable.strings.

Configure your files

Use this i18n.yml for the example, or add its file mapping to your existing bucket. See path templates for other layouts.

Translate

Install the CLI and set OPENAI_API_KEY in your project’s .env.local or shell. You can also configure another AI provider.
The dry run previews the work. The second command writes translations to the configured target path and updates the lockfile.

Behavior and limitations

  • Parses quoted "key" = "value"; entries, including escaped characters, Unicode escapes, and multiline values.
  • Writeback preserves template comments, layout, and spacing while replacing value literals.
  • Leading comments can supply a character limit, for example hl:max-length=40. Keep printf placeholders intact.

Next steps