# shopify-language-sync

> Tool to synchronise a Shopify them live translation with a local translation file. This tools works for slate and themekit projects

Latest version **2.0.1** (published 2021-05-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install shopify-language-sync
pnpm add shopify-language-sync
yarn add shopify-language-sync
bun add shopify-language-sync
```

Provides the command `locales-sync`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.1 |
| Published | 2021-05-26 |
| First published | 2020-07-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 19.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Diego Pelaez |
| Maintainers | dnpg |
| Keywords | Shopify, Translation, Tool |

## Links

- npm: https://www.npmjs.com/package/shopify-language-sync
- Repository: https://github.com/dnpg/shopify-language-sync
- Homepage: https://github.com/dnpg/shopify-language-sync#readme
- Issues: https://github.com/dnpg/shopify-language-sync/issues
- npm.io page: https://npm.io/package/shopify-language-sync

## Dependencies (6)

- [chalk](https://npm.io/package/chalk.md) ^4.1.0
- [dotenv](https://npm.io/package/dotenv.md) ^8.2.0
- [figures](https://npm.io/package/figures.md) ^3.2.0
- [minimist](https://npm.io/package/minimist.md) ^1.2.5
- [browserslist](https://npm.io/package/browserslist.md) ^4.16.5
- [@shopify/themekit](https://npm.io/package/@shopify/themekit.md) ^1.1.4

## Alternatives

- [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads
- [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads
- [react-native-ios-utilities](https://npm.io/package/react-native-ios-utilities.md) — 138.5K weekly downloads
- [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads
- [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads

## Recent versions

- 2.0.1 (latest) — 2021-05-26
- 2.0.0 — 2021-05-25
- 1.0.4 — 2021-03-17
- 1.0.3 — 2020-07-28
- 1.0.2 — 2020-07-21
- 1.0.1 — 2020-07-21
- 1.0.0 — 2020-07-21

## README

# shopify-language-sync

Tool to synchronise a live Shopify translation with a local translation file.

This was created while using [Slate](https://github.com/Shopify/slate) as a base project (Note that Slate ended support in January 2020)

# Installation

```
yarn add shopify-language-sync
```

# Version 2 updates

When using version 2, you must pass the required flag depending of the type of Shopify theme you are working on

## Themekit

You must pass a --themeConfig flag

```
locales-sync --themeConfig config.yml
```

### Example

```
...
    "scripts": {
        ...
        "sync": "locales-sync --themeConfig config.yml --srcDir=./source/locales --destDir=./dest/locales",
        ...
    }
...
```


## Slate
You must pass a --slateEnv flag

```
locales-sync --slateEnv .env
```

### Example

```
...
    "scripts": {
        ...
        "sync": "locales-sync --slateEnv .env",
        ...
    }
...
```

# Setup

You neet to have a .env file with the settings for your project, same structure as https://shopify.github.io/slate/docs/connect-to-your-store

Example .env file with minimum required information

```
# The myshopify.com URL to your Shopify store

SLATE_STORE={store-name}.myshopify.com

# The API password generated from a Private App

SLATE_PASSWORD=ccf7fb19ed4dc6993ac6355c0c489c7c7

# The ID of the theme you wish to upload files to

SLATE_THEME_ID=32112656003

```

Update your package.json scripts

```
...
"scripts": {
    ...
    "build": "slate-tools build && locales-sync --themeConfig config.yml --srcDir=./source/locales --destDir=./dest/locales",
    ...
```

# How it works

Using [themekit](https://shopify.github.io/themekit/), this tool downloads your theme's locales directory to a ./tmp/locales in your project.
Then updates your src translation with the content in tmp and replaces it in your destination directory.

# Example using Slate

In slate, all your files are under a ./src directory. The translations are in ./src/locales

Lets say we have a directory with the following structure

```

-   src
    ...
    -   layout
    -   locales
        en.default.json
        es-AR.json
        fi.json
        ...

```

We know that the locales file can be updated by the Store owner and staff at any time. We need to get the latest translations from the live site, but at the same time we want to update the structure with the latest changes in our code.

This tool takes the ./src/locales as the translation structure and replaces any existing values stored in Shopify.

Let's say that our ./src/locales/en.default.json file looks like this

```
{
    general: {
        hello: 'Hello',
        thanks: 'Thanks',
    },
    test: 'Test',
    nonExistent: 'Now Exisits',
}
```

And the file currently in Shopify looks like this:

```
{
    general: {
        hello: 'Hola',
        how_are_you: 'This is deleted',
        thanks: 'Thanke',
    },
    test: 'Another test',
}
```

After this tool run, the final result is:

```
{
    general: {
        hello: 'Hola',
        thanks: 'Thanke',
    },
    test: 'Another test',
    nonExistent: 'Now Exisits',
}
```

## Example of package.json script to build a slate project with locales sync

```
"scripts": {
    ...
    "build": "slate-tools build && locales-sync --slateEnv .env",
    ...
}
```

# Arguments

If you are not using Slate or have a different folder structure you can pass the following arguments

| Argument    | Description                   | Default        | Example                     |
| ----------- | ----------------------------- | -------------- | --------------------------- |
| slateEnv    | Slate environment config file |                | --slateEnv .env             |
| themeConfig | Themekit config file          |                | --themekitConfig config.yml |
| srcDir      | Source directory              | ./src/locales  |                             |
| destDir     | Destination directory         | ./dist/locales |                             |

## Example of package.json script to build a themekit project with locales sync

```
...
"scripts": {
    ...
    "sync": "locales-sync --themeConfig config.yml --srcDir=./source/locales --destDir=./dest/locales",
    ...
}
```

---
_Source: https://npm.io/package/shopify-language-sync · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._