# run

Runs an Architect target with an optional custom builder configuration defined in your project.

## Usage

```bash
nx run <target> [options]
```

[Install `nx` globally]({{framework}}/getting-started/nx-setup#install-nx) to invoke the command directly using `nx`, or use `npx nx`, `yarn nx`, or `pnpx nx`.

### Examples

Run the `build` target for the `myapp` :

```bash
nx run myapp:build
```

Run the `build` target for the `myapp` project with a `production` configuration:

```bash
nx run myapp:build:production
```

## Options

### configuration (-c)

A named builder configuration, defined in the "configurations" section of the workspace configuration file. The builder uses the named configuration to run the given target.

### help

Show help

### version

Show version number