Documentation section

Quick Start - iOS & macOS

Localize your iOS or macOS app with Localazy CLI.

Upload Localizable files to Localazy and manage your translations easily. Download translated files back.

1. Install Localazy CLI for your operating system.

2. Create a configuration file localazy.json in the root of your project. You can start with our sample:


  "writeKey": "your-write-key",
  "readKey": "your-read-key",
  "upload": {  
    "type": "ios-strings",
    "files": "Base.lproj/Localizable.strings"
  "download": {
    "files": "${iosLprojFolder}/${file}"

3. Upload the source strings with localazy upload whenever you change them.

4. Download translated files with localazy download before building your app.

See full iOS/macOS documentation for .strings, .stringsdict, .plist and XLIFF files.

You can upload all your existing translations too! Learn more about it.

Localazy CLI is simple to start yet flexible enough for any project. Let’s take a quick tour.