> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lazylocales.com/llms.txt
> Use this file to discover all available pages before exploring further.

# push

> Push the source locale file to LazyLocales

The `push` command uploads your source locale file to LazyLocales and computes a diff against the previous version. It does **not** trigger translation — use [`translate`](/cli/translate) for that.

## Usage

```bash theme={null}
npx lazylocales push [options]
```

## Options

| Flag        | Description                                 |
| ----------- | ------------------------------------------- |
| `--dry-run` | Show what would be pushed without uploading |
| `--json`    | Output machine-readable JSON                |

## What it does

<Steps>
  <Step title="Read source file">
    Reads the source locale file from the path defined in your config
    (e.g. `./public/locales/en.json`).
  </Step>

  <Step title="Upload to LazyLocales">
    Sends the file content to the API. The server computes a diff against the
    previous version and stores the new version.
  </Step>

  <Step title="Show diff summary">
    Displays what changed:

    ```
    ✓ Version 4 — 142 keys
    Changes: +3 added, ~1 modified, -0 deleted
    ```
  </Step>
</Steps>

## Examples

Push the source file:

```bash theme={null}
npx lazylocales push
```

Preview what would be pushed:

```bash theme={null}
npx lazylocales push --dry-run
```