
Hey there! In the latest update, I implemented a frequently requested feature which is **multi-file support** in a new version of [SimpleLocalize CLI](https://github.com/simplelocalize/simplelocalize-cli), and I wanted to share with you how to use it.
See the below updates that should help you in your daily translation and management work with SimpleLocalize. ☺️

![How to download translation using command-line tool](/docs/cli-download-translations.mp4)

## Multi-file support

Multi-file support gives you a possibility to upload and download files which have a structure like below.

```bash
.
├── ca
│   ├── common.json
│   └── home.json
├── en
│   ├── common.json
│   └── home.json
└── es
    ├── common.json
    └── home.json
```

The newest version of CLI will automatically detect if you are trying to upload or download files with namespaces and/or languages.
Namespaces in the example above are `home` and `common`, and languages are `ca`, `en`, `es`.


## How to upload translations?

To upload such structure of translations, you can simply run command like below:
```shell
simplelocalize upload
  --apiKey <PROJECT_API_KEY>
  --uploadPath /{lang}/{ns}.json
  --uploadFormat single-language-json
```

In the example above, `{ns}` is a namespace and `{lang}` is a language.

See [upload command](/docs/cli/upload-translations/) documentation page.

## How to download translations?

Once you finish translating your content, you can run a download command to update translation files or/and add new ones!

```shell
simplelocalize download
  --apiKey <PROJECT_API_KEY>
  --downloadPath /{lang}/{ns}.json
  --downloadFormat single-language-json
```

See [download command](/docs/cli/download-translations/) documentation page.

## Options flag is now available

You can use CLI to download [all available file formats](/docs/general/file-formats/). Some formats offer additional options, for example if you would like to download
an Excel file with translations and translation key descriptions, you can run:

```shell
simplelocalize download
  --apiKey <PROJECT_API_KEY>
  --downloadPath /locales/translations.xlsx
  --downloadFormat excel
  --downloadOptions INCLUDE_DESCRIPTIONS
```

You can see currently available options in the 'Data' tab in the project view, when Developer mode is turned on in the top-right corner.

![export translations section](/blog/export-translations-cli-options-menu.png)


Additional options are also supported in the Upload command, and you can apply them respectively with `--uploadOptions` parameter.

## Faster CLI and smaller file size

SimpleLocalize CLI 2.0 brings many small improvements, one of those is much smaller CLI size. **The newest version is only 15 megabytes**, comparing to the previous 1.1.x version with 50 megabytes. CLI still has zero dependencies,
which means you don't need to have Java, Python, node or any other software to run the CLI.

Other improvements:
- better compatibility between operating systems,
- new API which responds much faster for CLI requests,
- better error handling,
- more meaningful error messages.

## How to update or install CLI?

To install CLI version 2.x, you can invoke the command below. It will automatically detect your operating system and download SimpleLocalize CLI.
If you would like to download CLI executable manually, without the script, you can find [all CLI releases on GitHub](https://github.com/simplelocalize/simplelocalize-cli/releases).

```shell
curl -s https://get.simplelocalize.io/2.2/install | bash
```

## How to check what CLI version I'm running?

You can simply check what is your current CLI version by running CLI with `--version` parameter.
```shell
simplelocalize --version
or
simplelocalize-cli --version
or
./your-downloaded-simplelocalize --version
```

## Troubleshooting

If you have any troubles with CLI, please visit [troubleshooting page](/docs/cli/troubleshooting/) for solutions.
You can also [report the problem on GitHub](https://github.com/simplelocalize/simplelocalize-cli/issues).



## What's next?

In the upcoming weeks, I would like to focus on adding more CLI small features based on the given feedback.

Keep an eye on [changelog](/changelog), [my Twitter](https://twitter.com/jakub_pomykala) or [SimpleLocalize Twitter](https://twitter.com/simplelocalize).
Thank you all for your e-mails and all the feedback you provide me with. Have a great day! ☺️


CLI 2.0 with multi-file support


## Background

To provide the best experience from our product, we needed to make important changes in our naming convention.
From now `uploadToken`, `projectUploadToken`, `apiToken` will now be known as: `apiKey`. 
 
## Why are we changing this?
 
In the future, this will allow us to offer multiple API keys per project. When we started working on SimpleLocalize, we had the option to add new keys and edit them in Web UI. Today, we are giving offering much more than a simple upload/import feature. 
Our product offers: 
- translation key extraction CLI,
- content delivery network, 
- import translations from Excel file, 
- export translations to JSON from Excel file,
- unlimited rollbacks,
- more important API access, which allows you to manipulate translations. 

We know that many of you are using SimpleLocalize as a tool to save time and build your integrations. 
We hope that this change will help our future clients and won't be and an obstacle for our current clients. 

![use api key to rule them all](/blog/one-api-key-to-rule.jpg)

## What do I need to do?

Changes are transparent for your current 3rd party integrations. 
There is no need to update anything. We are changing our naming convention to simplify our platform. 
If you are using [SimpleLocalize CLI](https://github.com/simplelocalize/simplelocalize-cli) 
then please read the next section.

## Patching your SimpleLocalize CLI configs

Update your `simplelocalize.yaml` configuration file and rename `uploadToken` property to `apiKey`.
`uploadToken` will be supported until November 2021.

```yaml
uploadToken: <PROJECT_UPLOAD_TOKEN>
projectType: yahoo/react-intl
```

change to

```yaml
apiKey: <API_KEY>
projectType: yahoo/react-intl
```

## Where can I find my API Key?

Every project has assigned one unique API Key. You will find it in the project 'Integration' tab in the 'Custom Integration' section.

![api-key-in-integration-tab](/blog/api-key-integration-tab.png)

Check out updated [API Documentation](/docs/api/get-started)

For any questions, please contact us: contact@simplelocalize.io


Translation Hosting

SimpleLocalize CLI

REST API

Auto-translation

Alternative translations

Cli

CLI 2.0 with multi-file support

Deprecating project upload tokens and upload tokens