📦 @localazy/cli

Upload source strings to Localazy and download translations back into your project. Works with all i18n file formats and fits into your existing CI/CD pipeline.

🔧 Install

npm install -g @localazy/cli
# or run without installing
npx @localazy/cli [command]

🚀 Usage

Configure the CLI with a localazy.json file in your project root:

{
  "writeToken": "your-write-token",
  "readToken": "your-read-token",
  "upload": {
    "files": [
      {
        "path": "src/locales/*/en.json",
        "type": "json"
      }
    ]
  },
  "download": {
    "files": [
      {
        "path": "src/locales/*/${lang}.json",
        "type": "json"
      }
    ]
  }
}

Then push and pull translations:

localazy upload    # Upload source strings to Localazy
localazy download  # Download completed translations into your project

⌨️ Commands

localazy [proxy] [command] [common options] [groups/subcommands] [subcommand options]

• upload - Run upload rules to collect files and upload them to Localazy servers for processing.
• download - Download files from Localazy servers and run download and conversion rules on them.
• translate - On-demand, realtime AI translation directly from the command line using your Localazy project context.
• batch - Translate uploaded strings, approve those waiting for review or apply translation memory from your command line.
• list - List files all translated files available on the server.
• languages - List languages available in your Localazy project including their current state.
• file - Manage (rename and delete) files on the server.
• tag - Manage release tags - list, publish and delete tags.
• cdn - List all files on the Localazy CDN.
• conversion - Access information about file format conversions.
• branch - Create, list, merge and delete branches.

For help, invoke localazy [command] -h or read the full command reference in the docs.

🔐 Project access keys

Generate your read and write keys at localazy.com/console/cli-keys.

Each access key is scoped to a single project. Use writeToken for uploads and readToken for downloads — or store them as environment variables to keep them out of version control.

📚 Documentation & guides

• CLI documentation
• Command reference
• CI/CD integration guides

🛟 Support

Join the Localazy Discussion Forum for questions and community help.

For bugs and feature requests, reach us at [email protected].

❤️ Localazy Ecosystem

Check out other npm packages from Localazy:

| | NPM package | Description | | :------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | | @localazy/cli | Upload and download translation files from the command line or CI/CD. | | | @localazy/api-client | Node.js client for the Localazy API with full TypeScript support. | | | @localazy/languages | Complete list of languages and locales supported by Localazy. | | | @localazy/strapi-plugin | Official Localazy plugin for Strapi headless CMS. |