---
createdAt: 2024-08-11
updatedAt: 2026-09-27
priority: 5
title: "intlayer build: Build Dictionaries from Content"
description: Learn how to build your Intlayer dictionaries from content declaration files.
keywords:
  - Build
  - Dictionaries
  - CLI
  - Intlayer
slugs:
  - doc
  - concept
  - cli
  - build
history:
  - version: 9.5.2
    date: 2026-09-12
    changes: "Add `--ci` flag"
  - version: 8.1.5
    date: 2026-02-23
    changes: "Add checkTypes option"
author: aymericzip
---

# Build Dictionaries

To build your dictionaries, you can run the commands:

```bash packageManager="npm"
npx intlayer build
```

```bash packageManager="yarn"
yarn intlayer build
```

```bash packageManager="pnpm"
pnpm intlayer build
```

```bash packageManager="bun"
bun x intlayer build
```

or in watch mode

```bash packageManager="npm"
npx intlayer build --watch
```

```bash packageManager="yarn"
yarn intlayer build --watch
```

```bash packageManager="pnpm"
pnpm intlayer build --watch
```

```bash packageManager="bun"
bun x intlayer build --watch
```

This command will find your declaration content files as default as `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}`. And build the dictionaries in the `.intlayer` directory.

## Aliases:

- `npx intlayer dictionaries build`
- `npx intlayer dictionary build`
- `npx intlayer dic build`

## Arguments:

- **`--base-dir`**: Specify the base directory for the project. To retrieve the intlayer configuration, the command will look for the `intlayer.config.{ts,js,json,cjs,mjs}` file in the base directory.

  > Example: `npx intlayer build --base-dir ./src`

- **`--env`**: Specify the environment (e.g., `development`, `production`). Useful in the case you use environment variables in your intlayer configuration file.

  > Example: `npx intlayer build --env production`

- **`--env-file`**: Provide a custom environment file to load variables from. Useful in the case you use environment variables in your intlayer configuration file.

  > Example: `npx intlayer build --env-file .env.production.local`

- **`--with`**: Start command in parallel with the build.

  > Example: `npx intlayer build --with "next dev --turbopack"`

- **`--skip-prepare`**: Skip the prepare step.

  > Example: `npx intlayer build --skip-prepare`

- **`--no-cache`**: Disable the cache.

  > Example: `npx intlayer build --no-cache`

- **`--ci`**: Run the command in every Intlayer project of the monorepo (or only the current one when run from a project directory). Per-project credentials can be injected via `INTLAYER_PROJECT_CREDENTIALS`, a JSON map of project path to `{ "clientId", "clientSecret" }`.

  > Example: `npx intlayer build --ci`

- **`--check-types`**: Check types of the content declaration files.

  > Example: `npx intlayer build --check-types`