release

ALPHA: Orchestrate versioning and publishing of applications and libraries

Usage

nx release

Install nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpm nx.

Options

dryRun

Type: boolean

Default: false

Preview the changes without updating files/creating releases

groups

Type: string

One or more release groups to target with the current command.

help

Type: boolean

Show help

projects

Type: string

Projects to run. (comma/space delimited project names and/or patterns)

verbose

Type: boolean

Prints additional information about the commands (e.g., stack traces)

version

Type: boolean

Show version number

Subcommands

version

Create a version and release for one or more applications and libraries

nx release version [specifier]

Options

help

Type: boolean

Show help

preid

Type: string

The optional prerelease identifier to apply to the version, in the case that specifier has been set to prerelease.

specifier

Type: string

Exact version or semver keyword to apply to the selected release group.

version

Type: boolean

Show version number

changelog

Generate a changelog for one or more projects, and optionally push to Github

nx release changelog [version]

Options

createRelease

Type: string

Choices: [github]

Create a release for the given version on a supported source control service provider, such as Github.

file

Type: string

Default: CHANGELOG.md

The name of the file to write the changelog to. It can also be set to false to disable file generation. Defaults to CHANGELOG.md.

from

Type: string

The git reference to use as the start of the changelog. If not set it will attempt to resolve the latest tag and use that

gitRemote

Type: string

Default: origin

Alternate git remote in the form {user}/{repo} on which to create the Github release (useful for testing)

help

Type: boolean

Show help

interactive

Type: boolean

tagVersionPrefix

Type: string

Default: v

Prefix to apply to the version when creating the Github release tag

to

Type: string

Default: HEAD

The git reference to use as the end of the changelog

version

Type: string

The version to create a Github release and changelog for

publish

Publish a versioned project to a registry

nx release publish

Options

all

Type: boolean

Default: true

[deprecated] run-many runs all targets on all projects in the workspace if no projects are provided. This option is no longer required.

exclude

Type: string

Exclude certain projects from being processed

graph

Type: string

Show the task graph of the command. Pass a file path to save the graph data instead of viewing it in the browser.

help

Type: boolean

Show help

nxBail

Type: boolean

Default: false

Stop command execution after the first failed task

nxIgnoreCycles

Type: boolean

Default: false

Ignore cycles in the task graph

output-style

Type: string

Choices: [dynamic, static, stream, stream-without-prefixes]

Defines how Nx emits outputs tasks logs

parallel

Type: string

Max number of parallel processes [default is 3]

projects

Type: string

Projects to run. (comma/space delimited project names and/or patterns)

registry

Type: string

The registry to publish to

runner

Type: string

This is the name of the tasks runner configured in nx.json

skipNxCache

Type: boolean

Default: false

Rerun the tasks even when the results are available in the cache

tag

Type: string

The distribution tag to apply to the published package

verbose

Type: boolean

Prints additional information about the commands (e.g., stack traces)

version

Type: boolean

Show version number