Get up to speed with Respresso guides

Respresso is a great tool with a lot of really useful features that are hard to master when you need to use advanced features. We aim to keep most of Respresso's capabilities and even extend it while making it easier to learn and use. For this reason we made guides (aka. step-by-step tutorials) to make Respresso "easy to start".

This folder is going to slowly grow and include more and more step-by-step guides to show you the features for specific use-cases. If you don't find your use-case here, try to discover the other parts of docs, hopefully you will find the answer you are looking for. If your need assistance with Respresso, feel free to contact us at, so we can help you.

Project setup for new and existing projects

See the following guides if you are adding Respresso to your project:

  • Android with Gradle task for auto-sync
  • iOS with Xcode Build Phase for auto-sync
  • Web with NPM script. (Framework independent)

Respresso is capable of generating a huge variety of formats and even lets you add your own converter using Respresso Flow. Thanks to this, you can use it for other project types. E.g. we have clients who use it for their Node.js backend for email/push localization and email styling.

Migrate your Respresso project to the new CLI

Previously, Respresso had platform-specific tools with very limited capabilities to support automatic updates of your resource files. This changed when we released the new Respresso CLI that provides the same configuration options with a unified sync experience across all platforms and operating systems. In addition to this, it provides highly customizable file placement, automatic local git ignore, quick project initialization with automatic configuration of Android, iOS and Web projects.

Unfortunately, this huge leap forward came at the price of breaking changes. The new client is incompatible with the previous ones and some formats had to be adjusted to properly work out of the box in the new environment. To ease the transition, we made a guide with step-by-step instructions to transition to the new one:

  • Android : Change affects only your build.gradle .
  • iOS : Change affects project structure, build script and minimally some resource files.
  • Web : Change only affects package.json and respresso.json .