Nx Release

Recipes for releasing with Nx release.

Get Started with Nx Release

Learn how to use Nx Release to version packages, generate changelogs, and publish packages in your JavaScript monorepo with a step-by-step guide.

Release Projects Independently

Learn how to configure Nx Release to version and publish projects independently in your monorepo, allowing different release schedules for different projects.

Updating Version References in Manifest Files (e.g. package.json)

Learn how to configure Nx Release to update version references in package.json and other manifest files, including strategies for source files, custom dist directories, and local dependency references.

Automatically Version with Conventional Commits

Learn how to configure Nx Release to automatically determine version bumps based on conventional commit messages, enabling automated versioning in CI/CD pipelines.

Customize Conventional Commit Types

Learn how to configure Nx Release to customize how different conventional commit types affect versioning and changelog generation, including changing semver bump types and section titles.

File Based Versioning (Version Plans)

Learn how to use Nx Release's version plans feature to track version bumps in separate files, similar to Changesets or Beachball, allowing for more flexible versioning workflows.

Configure Custom Registries

Learn how to configure Nx Release to publish packages to custom npm registries, including setting up multiple registries for different package scopes and per-package registry configuration.

Publish in CI/CD

Learn how to configure Nx Release to automate your package publishing process in CI/CD pipelines, including authentication, environment setup, and workflow examples.

Automate GitHub Releases

Learn how to configure Nx Release to automatically create GitHub releases with changelogs generated from your conventional commits, for both workspace and project-level releases.

Automate GitLab Releases

Learn how to configure Nx Release to automatically create GitLab releases with changelogs generated from your conventional commits, for both workspace and project-level releases.

Publish Rust Crates

Learn how to version Rust libraries, generate changelogs, and publish Rust crates in a monorepo using Nx Release with a step-by-step guide.

Update Your Local Registry Setup to use Nx Release

Learn how to update your existing local registry setup to use Nx Release for publishing packages during end-to-end testing, replacing older publish target approaches.

Configure Changelog Format

Learn how to customize the format of changelogs generated by Nx Release, including options to control author information, commit references, and version title dates.

Build Before Versioning

Learn how to configure Nx Release to build your projects before applying version updates, ensuring that distribution files are properly generated before publishing.

Configuring Version Prefix for Dependency Versions

Learn how to set up custom version prefixes in Nx Release to control how dependency versions are specified in your manifest files (such as package.json, Cargo.toml, etc.), with options for exact, patch, or minor-level compatibility.