For this guide, we use Brew to install mojito Webapp and CLI (Java 1.8 is required).

Setup and install

brew tap box/mojito
brew install mojito-cli
brew install mojito-webapp

Start the Webapp


This starts the server on http://localhost:8080. You can log in with admin/ChangeMe.

start webapp

Create a demo repository

mojito demo-create -n Demo1

It creates a new repository called Demo1 in the server with some translations. A resource bundle is copied on the local directory Demo1.

create demo repository

Generate the localized files

cd Demo1
mojito pull -r Demo1

It goes into Demo1 directory and generates the localized files. You can see the generated file with cat

create demo repository

Add a new string

printf "\nFOR_DEMO=Add a string for the demo" >>
mojito push -r Demo1

It adds a new string with ID FOR_DEMO and English value Add a string for the demo in the resource bundle and sends the modified bundle to the server.

add new string


Check in the Workbench that the string was added and is untranslated. Try adding a translation.


Generate new localized files

mojito pull -r Demo1

Finally, this generates the updated localized files with the new translation.

update localized filwa

What’s next?

We have covered the main commands of mojito using a demo project that was created with demo-create command. The next step is to do the setup for a real application.

First, you want to look at how to create a repository in more details with the repo-create command. We recommend to use one repository by application localized: IOS, Android, Webapp, etc.

If your application already has localized files, checkout the import command. This command allows you to import your previous translation.