Start here

The place where the magic begins!

Build Status Maintainability codecov Gitter

⚡️ SimpleLocalize CLI - What it does?

CLI will find i18n keys in you source code which are used by your library and push them to the cloud, where you will be able to translate keys and publish to the CDN and download in desired format.

For example to translate frontend application in ReactJS you can use yahoo/react-intl which looks like follows:

<FormattedMessage id="LOGIN"/> //i18n key = "LOGIN"

thanks to our command line tool will find key LOGIN and push it the SimpleLocalize cloud, where you will be able to:

  1. translate this key to multiple languages [see video],

  2. invite teammates to help you with translations,

  3. publish changes to the CDN,

  4. and finally fetch translated data directly to your application.

This solutions works great with yahoo/react-intl beacause you can publish changes to deployed application and see new translations immediately!

🛠 Configuration

  • Create new project: https://app.simplelocalize.io

  • Select project type which determine translations output format.

  • Go to project settings and in section Project Credentials, download configuration properties.

Example simplelocalize.yml

uploadToken: <PROJECT_UPLOAD_TOKEN>
projectType: <SEE_SUPPORTED_LIBRARIES_LIST>

To find proper value for projectType property, go to CLI supported libraries page.

🚀 Usage

Type in terminal or in bash file following command:

$ curl -s https://get.simplelocalize.io | bash

Done, now you can refresh the project page and see what new keys we have.

See short video about SimpleLocalize cloud editor. [10 seconds]

Remember to put simplelocalize.yml in same directory where you invoke this command. CLI will find all i18n keys in current directory and push them to SimpleLocalize cloud.