Translations (i18n)


Ensemble supports localization of app content so that your app users can view the app in their preferred language.

How it works

When an app loads, Ensemble checks the defualt language of the device (e.g. languages setting in iOS, Android, or Chrome browser).

  1. If device default langugae is supported by your app, Ensemble uses that language.
  2. Else, Ensemble uses the app's default language.

Set up languages

In Ensemble Studio, navigate to your app and select Translations from the left menu. Add new language to start with.

The first language you add is set as the default. You can update the default language when you add more by clicking the ... menu on the language.

add language

Add language content

Language content is created in YAML. Add key/value pairs for each text.

add language

Organize the content

To make it easier to find and update the text, you can create a hierarchy within language files. For instance, you can have common text under common and text related to login screen under login

    submit: Submit
    error: Something went wrong. Try again.
    login_button: Sign in
    login_error: Incorrect username or password. Please try again.

Reference the translation

In any screen or widget, reference the translations. E.g. for a button, assign the reference to the label property.

When refrencing translations, prepend r@ before the key assigned to the text:

- Button:
    label: r@login.login_button

Test in Preview

Use the 🌎 icon on top of the preview to select a language. The preview updates and shows the UI in the selected language.

add language