1. Help Center
  2. Setup
  3. Set up Phrase for any technology or platform

Other technologies

This guide describes a generic integration of Phrase with any software project.


We have recently updated our CLI, instead of phraseapp, it is  now called phrase.

Although we try to keep things as similar and compatible as possible, there might be some changes.

All documentation now refers to the phrase CLI.

If you have any questions, please contact us at support@phrase.com.

How to use Phrase with any technology or platform


  1. Install the Phrase command line client
  2. phrase init
  3. phrase push
  4. phrase pull

Note: This guide assumes you have signed up for Phrase and your application is ready for localization, i.e. you have your (source) translations in one of our supported formats.

1. Install the Phrase Client

Download the latest Phrase Client and follow the setup instructions.

2. Configure the command-line tool for your project

To initialize the project configuration, just follow the instructions to initialize the Phrase command-line tool:

$ phrase init

This will guide you through the necessary steps to configure your sources and targets for your project. Make sure you select the correct locale file format during the initialization.

3. Upload locale files

Next, upload your existing localization files to Phrase by executing the push command:

$ phrase push

All existing localization files found in your source path will be uploaded to your Phrase project. Log into Translation Center to see your existing translations and add new languages or keys.

4. Download locale files

Once you have finished working on your translation in Translation Center or the In-Context Editor, you might want to download the data back into your project. This can be done by executing the pull command:

$ phrase pull

Where to go from here?

With the simple push and pull commands you now already have a basic workflow to collaborate on your locale files with Phrase. See the following articles to learn more about how to streamline your localization process.

Working with Phrase

Learn how to work efficiently with Phrase in this getting started guide.

Enable In-Context Editor

When localizing a web application we recommend using the In-Context Editor. See this guide for installation instructions: In-Context-Editor Documentation