Nx
Dev ToolsGet to green PRs in half the time. Nx optimizes your builds, scales your CI, and fixes failed PRs. Built for developers and AI agents.
Release History
22.7.0-beta.1219 fixes3 featuresThis beta release introduces new features like setup mode prompting during nx init and source map annotations for show targets. It also includes numerous bug fixes across core, angular, js, linter, and testing modules, alongside an update to the axios dependency.
22.6.532 fixes4 featuresThis release introduces new features for the 'nx init' command, including cloud prompt variants and setup mode prompting. It also includes numerous bug fixes focused on dependency updates, security patches (axios CVE), build tool compatibility (esbuild/vite 8), and improved task execution cleanup.
22.7.0-beta.118 fixes2 featuresThis beta release introduces the ability to skip project graph creation during generation and removes the polygraph cloud passthrough. It also includes several fixes related to dependency licensing, task cleanup, and Gradle/Maven plugin behavior.
22.7.0-beta.1015 fixes2 featuresThis beta release focuses on stability and security by bumping critical dependencies like axios and esbuild, alongside various fixes for plugin loading, repository operations, and build configurations.
22.6.422 fixes2 featuresThis patch addresses numerous bug fixes across core functionality, JS tooling, and build systems, including updates for Vite 8 compatibility and dependency security patches. Key improvements involve better handling of workspace creation and build output narrowing.
22.7.0-beta.96 fixesThis beta release focuses on bug fixes across core functionality, telemetry, Gradle integration, React setup, and repository tooling, including restoring telemetry tracking and fixing lock-thread failures.
22.7.0-beta.814 fixes2 featuresThis release introduces updates to telemetry format and enables the tsgo compiler. It also includes numerous bug fixes across core, Gradle, JS, Vite, and Webpack related to validation, dependency pinning, hashing, and compatibility updates for Vite 8.
22.7.0-beta.74 fixes1 featureThis beta release introduces a conditional blog/changelog proxy in the nx-dev edge function and includes several fixes related to dependency checks, tsc build outputs, and copy-assets plugin improvements.
22.6.33 fixes1 featureThis release introduces an A/B test for cloud prompt copy in workspace creation and includes several minor fixes related to TypeScript d.ts filesets and chalk compatibility.
22.7.0-beta.64 fixes1 featureThis beta release introduces an A/B test for cloud prompt copying in workspace creation and includes several internal fixes related to package exports, TypeScript file sets, and plugin migration.
22.7.0-beta.512 fixes2 featuresThis beta release introduces features like auto-opening the browser for Cloud setup and updates repository handling, alongside numerous bug fixes across bundling, core execution, and Vite support.
22.6.231 fixes2 featuresThis patch introduces auto-opening the browser for Cloud setup during workspace creation and fixes numerous bugs across core functionality, bundling, angular, and devkit. It also adds support for Vite 8.
22.7.0-beta.410 fixes1 featureThis beta release introduces a significant core feature decoupling the DB version from the Nx version, allowing DB sharing across worktrees. It also includes numerous bug fixes across various plugins like angular-rspack, core, gradle, js, nx-cloud, and vitest.
22.7.0-beta.310 fixesThis beta release focuses on stability and bug fixes across core functionalities, including improvements to the TUI, task concurrency handling, and native scanner behavior.
22.7.0-beta.26 fixes1 featureThis beta release focuses on stability and bug fixes, including improvements to child process handling, linter configuration, and module federation output for Angular.
22.6.119 fixesThis patch release focuses heavily on bug fixes across core functionality, task execution, dependency handling, and linter rules, including improvements to shell argument quoting and process spawning on Windows.
22.7.0-beta.11 fixThis beta release primarily focuses on a critical bug fix in the core module to prevent database corruption during concurrent initialization.
22.7.0-beta.015 fixes1 featureThis beta release introduces updates to gitignore, improves CLI argument quoting, and refines linter configuration handling, alongside various bug fixes across core and plugins.
22.6.018 fixes45 featuresThis release introduces significant enhancements around AI agent integration, including sandboxing, new modes for init/import, and improved configuration. It also brings performance improvements via jemalloc and updates to build tooling like Angular v21.2 support and napi-rs v3 migration.
22.6.0-rc.21 fix1 featureThis release brings back cloud prompts and templates in CNW and fixes an issue with cross site link checks in nx-dev.
22.6.0-rc.110 fixes2 featuresThis release introduces a new deps-sync generator for JavaScript projects and includes numerous fixes across core functionality, analytics handling, and build tool integration like Vite and Gradle.
22.6.0-rc.03 fixesRelease 22.6.0-rc.0 focuses on stability, ensuring signal handling for continuous tasks and improving Nx Cloud client download behavior.
22.6.0-beta.1418 fixes3 featuresThis beta release introduces new telemetry features and prompts for analytics preferences in the core. It also includes numerous bug fixes across Gradle, JS, Maven, Module Federation, Release, Testing, and Webpack plugins.
22.6.0-beta.135 fixes1 featureThis beta release introduces centralized performance tracking and fixes several issues, including gating TUI logger initialization and updating Nuxt to resolve a critical vulnerability.
22.6.0-beta.1210 fixes3 featuresThis beta release introduces persistence of the analytics session ID, enhancements to Gradle and Maven dependency reporting, and numerous fixes across core, JS, and webpack configurations.
22.6.0-beta.11Breaking8 fixes1 featureThis beta release introduces core analytics and fixes several issues across Gradle, JavaScript tasks, and the Vitest executor. Notably, Vitest configuration for report directories has changed to resolve against the workspace root.
22.6.0-beta.1013 fixes4 featuresThis beta release introduces the 'polygraph' command for cross-repo sessions and enhances caching utilities. It also includes numerous bug fixes across Angular, JS, core Nx functionality, and addresses several security CVEs.
22.5.417 fixes1 featureThis patch introduces minor features like updating gitignore for polygraph and fixes numerous bugs across core, build tools (Angular RSPack, Gradle, Maven, Vitest), and documentation redirects. It also updates the minimatch dependency.
22.6.0-beta.98 fixes2 featuresThis beta release introduces migration to napi-rs v3 and adds Codex subagent support for AI agent configuration. It also includes several bug fixes related to input resolution, caching, and loop detection.
22.6.0-beta.810 fixes1 featureThis beta release introduces an update to gitignore during migration and includes numerous bug fixes across Angular RSPack, Gradle, CLI search, redirects, and Vitest execution.
22.6.0-beta.72 fixes1 featureThis beta release introduces jemalloc with tuned decay timers in the core module and fixes an issue with canonical SSH URL support during `nx release`.
22.6.0-beta.66 fixes1 featureThis beta release introduces support for Angular v21.2 and includes several bug fixes across core, linter, maven, and testing functionalities.
22.5.332 fixes3 featuresThis patch introduces several core features like improved JSON output for listing and cloud opt-out, alongside numerous bug fixes across Angular, bundling, Gradle, JS tooling, and dependency updates including a fix for a minimatch CVE.
22.6.0-beta.58 fixes1 featureThis beta release introduces an explicit cloud opt-out feature for CNW and resolves several bugs across core, gradle, js, nx-dev, and vite modules.
22.6.0-beta.49 fixesThis beta release focuses primarily on bug fixes across various Nx components, including improvements to file watching on macOS, webpack environment variable handling, and release schema validation.
22.6.0-beta.39 fixes6 featuresThis beta release introduces several accessibility improvements, adds support for yarn berry catalogs, and includes fixes for Angular styling, bundling type-checking, and a security patch by bumping minimatch.
22.6.0-beta.23 fixes1 featureThis beta release introduces new debugging commands for cache inputs/outputs and resolves several stability issues, including hanging commands and incorrect nxCloudId generation.
22.5.219 fixes2 featuresThis patch introduces the use of static_vcruntime to eliminate the msvcrt dependency and includes numerous bug fixes across core functionality, task execution, and developer tooling.
22.6.0-beta.16 fixes1 featureThis beta release introduces the use of static_vcruntime to remove the msvcrt dependency and includes several bug fixes across core, maven, nx-dev, and repository CI compatibility.
22.6.0-beta.026 fixes17 featuresThis beta release introduces significant features around agentic workflows, including sandboxing, negation pattern support, and agentic mode in nx init. It also includes numerous bug fixes related to caching, output handling, and agent configuration.
22.5.115 fixes8 featuresThis release introduces features like agentic sandboxing and negation pattern support for plugin includes/excludes. It also includes numerous bug fixes across core functionality, maven plugin, and repository workflows.
21.3.121 fixThis patch release fixes an issue in the core where task outputs were not being tracked correctly based on path depth.
22.5.048 fixes20 featuresThis release introduces significant enhancements to AI agent integration, task execution visualization in the TUI, and updates to build tooling like SWC and Maven batch execution. Numerous bug fixes address stability issues across core daemon operations, TUI rendering, and CI/CD integrations.
22.5.0-beta.514 fixes7 featuresThis beta release introduces several core features, including improved AI agent handling and cloud client download capabilities. It also includes numerous bug fixes across core, gradle, and nx-dev modules, such as switching from chalk to picocolors.
22.5.0-beta.43 fixes1 featureThis beta release introduces the initial implementation of the task I/O service and fixes several bugs related to command injection and project short name handling.
22.4.59 fixes1 featureThis patch release introduces server-side page view tracking for documentation and includes numerous bug fixes across core, gradle, and maven executors, focusing on stability and security.
22.5.0-beta.312 fixes3 featuresThis beta release focuses heavily on bug fixes across core functionality, Gradle integration, and testing stability, alongside adding new features for Nx Cloud connectivity and documentation tracking.
22.4.42 fixes1 featureThis patch release introduces decorative banners for Nx Cloud CNW completion messages and resolves hanging test issues by adding a timeout to runCommandUntil and preloading vitest/node.
22.4.37 fixes2 featuresThis patch release focuses on minor feature additions, such as updating the Nx Cloud connect URL in templates, alongside several bug fixes across core, build tooling (Vite, Gradle), and developer experience.
22.5.0-beta.23 fixes3 featuresThis beta release focuses on updating underlying tooling like swc, improving Maven execution flexibility, and fixing minor issues in import suggestions and dead links within nx-dev.
22.5.0-beta.13 fixes2 featuresThis beta release introduces new features for cloud prompts and agent configuration, alongside several bug fixes including improved temporary directory handling and updates to React/Vitest configurations.
22.4.26 fixes2 featuresThis release introduces batch task display in the TUI and updates cloud command behavior to be silent when disconnected. Several bug fixes address resizing issues, GitHub push failures, and JSON schema validation.
22.5.0-beta.07 fixes2 featuresThis beta release introduces batch task display in the TUI and an option to prefer Node's strip types feature for TypeScript files. Several core and devkit bugs related to TUI stability, cleanup, and cloud command behavior have also been addressed.
22.4.13 fixesThis patch release focuses on stability, fixing issues related to daemon workspace cleanup and preventing hangs in the TUI by adjusting rwlock usage.
22.4.042 fixes21 featuresThis release introduces significant feature enhancements across Angular, Gradle, Maven, and Rspack, alongside numerous stability fixes for the core CLI, TUI, and various language plugins. Key updates include support for Angular v21.1 and improved dependency handling.
22.4.0-beta.56 fixes3 featuresThis beta release introduces new configuration options for angular-rspack and includes several core fixes addressing build stability, performance measurement, and process handling.
22.4.0-beta.44 fixes3 featuresThis beta release introduces support for Angular v21.1 and OpenCode AI agent detection, alongside performance improvements and fixes for Vitest configuration merging.
22.4.0-beta.38 fixes3 featuresThis beta release introduces project inference for `nx show project`, adds build skipping controls for Gradle/Maven, and fixes several issues related to dependency parsing, daemon reporting, and Maven publishing.
22.4.0-beta.29 fixes2 featuresThis beta release introduces new features for Gradle dependency exclusion and updates React ecosystem packages to address CVEs. It also includes numerous core fixes related to process handling, caching, and linter overrides.
20.8.41 fixThis patch release addresses a specific bug in the linter related to handling variable references within replaceOverride configurations.
22.4.0-beta.112 fixes6 featuresThis beta release introduces support for cwd specific hashes in core, bulk ESLint suppression for newer versions, and new options for rspack configurations. Several bug fixes address issues in Angular, Gradle, JS plugins, and Vitest configurations.
22.3.31 fixThis patch release primarily addresses a minor fix by removing the CNW A/B testing flow branching.
22.4.0-beta.013 fixes4 featuresThis beta release introduces support for ngrx v21 and zoneless cypress component testing in Angular, alongside various bug fixes across core, dotnet, and module-federation functionality.
22.3.29 fixes2 featuresThis release introduces support for ngrx v21 and zoneless cypress component testing in Angular. It also includes numerous bug fixes across core, linter, module federation, and testing utilities.
22.3.12 fixesThis patch release focuses on bug fixes, specifically ensuring no TUI is shown for single tasks in the core and resolving dependency graph issues for dotnet projects with multi-targeting and transitive dependencies.
22.3.042 fixes13 featuresThis release introduces significant updates for Angular (v21 support and Jest migrations) and enhances core performance, especially around package manager parsing (pnpm/yarn) and TUI usability. It also adds support for Prettier v3 and improves JS/SWC compilation logging.
22.3.0-beta.311 fixes5 featuresThis beta release introduces TUI enhancements, Prettier v3 support, and several Angular-related migrations, alongside numerous bug fixes across core, graph, and build systems.
22.2.75 fixes1 featureVersion 22.2.7 introduces the ability to customize the companion E2E project location in nx-plugin and includes several bug fixes across core, node, and web functionality.
22.3.0-beta.27 fixes1 featureThis beta release focuses on bug fixes across core, JavaScript tooling, and Next.js generators, including improved dependency hashing and SWC compatibility.
22.2.66 fixes1 featureThis release focuses on bug fixes, including improvements to dependency hashing with PNPM patches, better handling of package.json configurations, and adjustments for the latest @swc/cli version. A new option was added to the Next.js page generator.
22.2.53 fixesThis patch release focuses on bug fixes, including ensuring all database tables are created upfront and restoring a compatibility parameter for linking task details.
22.3.0-beta.110 fixesThis beta release focuses primarily on bug fixes across various Nx components, including performance improvements, compatibility adjustments for Angular and Prettier, and fixes related to module federation and release tagging.
22.2.415 fixes1 featureThis release focuses on stability and performance improvements across various Nx plugins, including better error handling for SWC compilation and fixes related to Angular migrations and module federation port checking.
22.3.0-beta.042 fixes8 featuresThis beta release introduces support for Angular v21, adds the NX_DEFAULT_OUTPUT_STYLE environment variable, and includes numerous fixes across core functionality, JS tooling, and build systems like Rspack and Webpack.
22.2.33 fixesThis patch release addresses several bugs, including an issue with SWC base URL registration and compatibility updates for Expo SDK 54+.
22.2.27 fixes3 featuresThis patch release introduces a new CnwError class, adds support for merging webpack externals, and includes various fixes related to package manager support (pnpm/yarn) and build tool configurations (tsgo, NodeNext).
22.2.119 fixes3 featuresThis release introduces new configuration options for output styling and rspack, alongside numerous bug fixes across core, bundling, angular, and repository tooling, including improvements to pnpm parsing and build stability.
21.2.18 fixes5 featuresThis release introduces new features like support for pnpm registry configuration and a copy-workspace-modules executor, alongside numerous bug fixes across Angular, core, Gradle, and the linter.
22.2.045 fixes15 featuresThis release introduces support for Expo 54 and Nuxt v4, alongside numerous bug fixes focusing on core stability, build tooling improvements (Rollup, Vitest), and enhanced linter compatibility with ESLint v9.
22.2.0-beta.44 fixes2 featuresThis beta release introduces a new targetNamePrefix option for Gradle and updates the Maven plugin version. It also includes several core optimizations and fixes related to bun lockfile parsing and release versioning.
22.2.0-beta.310 fixes5 featuresThis beta release introduces template support for workspace creation, updates Expo support to version 54, and includes numerous fixes across Angular rspack, Docker, core, and build tooling.
22.2.0-beta.2Breaking9 fixes1 featureThis beta release introduces migration support for @nx/vitest and includes numerous bug fixes across core, linter, nuxt, and testing utilities, notably updating ESLint compatibility and adjusting Jest plugin flags.
21.6.103 fixesThis patch release focuses on bug fixes, including updating the bundling mechanism, ensuring proper child process termination, and resolving a hanging issue during Storybook automigration.
22.1.33 fixes1 featureVersion 22.1.3 introduces a new migration path for Next 16 upgrades and resolves several bugs related to bundling, process management, and linting configurations.
22.2.0-beta.14 fixes3 featuresThis beta release introduces support for Nuxt v4 and Storybook 10.1, along with a Vitest 4 migration option for Vite users. Several internal fixes address bundling, process management, and linter configurations.
22.1.211 fixes1 featureThis patch introduces multiple Nx version detection in nx report and fixes several issues related to daemon race conditions, task propagation, and TypeScript configuration in Nest projects.
22.2.0-beta.018 fixes4 featuresThis beta release introduces features like multiple Nx version detection and improved Next.js migration support, alongside numerous bug fixes across core, linter, and various builders to enhance stability and correctness.
22.1.18 fixes2 featuresThis release introduces a new utility for loading ESLint rules from a directory and fixes several issues related to task caching, daemon execution, graph construction, and configuration handling across various plugins.
20.8.31 fixThis patch release primarily addresses a bug in the linter related to handling flat configuration overrides.
22.1.031 fixes33 featuresThis release focuses heavily on performance improvements, TUI enhancements (now default on Windows), and broad framework compatibility updates including Next.js 16 and Storybook 10. The Vitest implementation has also been modularized into a dedicated plugin.
21.6.91 fixThis patch release primarily addresses an issue in the JavaScript execution environment to ensure process completion before exit.
22.1.0-rc.52 fixes2 featuresRelease 22.1.0-rc.5 introduces new features for environment application in core and Gradle configuration, alongside fixes for deadlocks in the metrics collector and Storybook version comparison.
22.0.411 fixes3 featuresThis patch introduces new features for Docker build tagging and Maven target prefixing, alongside numerous bug fixes addressing lockfile caching, task scheduling, and process handling.
22.1.0-rc.42 fixes1 featureThis release introduces the skipDefaultTag option for the docker build target and fixes issues related to plugin resolution and process hanging.
22.1.0-rc.35 fixes1 featureThis release introduces improvements to the core console daemon check and includes several bug fixes across various plugins like gradle, maven, and vite, notably adding support for Vitest v4.
22.1.0-rc.21 fixThis release primarily addresses an issue in JavaScript tooling by skipping TypeScript project references migration in specific workspace configurations.
22.1.0-rc.1This release was solely a version bump with no accompanying code changes.
22.1.0-rc.04 fixes3 featuresVersion 22.1.0-rc.0 introduces new features like exporting TypeScript schema definitions and Maven target prefixing, while also fixing scheduling optimizations and removing system metrics collection.
22.1.0-beta.87 fixes3 featuresThis beta release introduces support for Vitest 4, splits the Vitest entrypoint, and includes several performance and stability fixes across core, JS, and release tooling.
22.1.0-beta.72 featuresThis beta release introduces support for Cypress v15 and modularizes Vitest functionality into its own dedicated Nx plugin.
Common Errors
CssSyntaxError2 reportsCssSyntaxError in NX often arises from using incorrect or unsupported CSS syntax within your project's stylesheets, especially when using features like `postcss-cli-resources` for asset handling. To resolve this, carefully review your CSS files (including those in libraries) and ensure all syntax is valid and supported by your configured PostCSS plugins; usually, updating or configuring PostCSS plugins like `postcss-url` to correctly resolve asset paths (e.g., URLs in `url()` functions) will fix the problem.
IllegalStateException1 reportThe "IllegalStateException" in nx often arises from duplicate task registrations within your nx.json or project configurations, such as defining the same target with identical executors multiple times. To resolve this, carefully review your nx.json, project.json (or equivalent config files), and any plugin configurations for redundant entries; remove any duplicate task definitions or consolidate them into a single, correctly configured target.
NullPointerException1 reportNullPointerException in nx typically arises when attempting to access a member (field or method) of an object reference that is currently null. To fix, identify the potentially null object reference in your code using debugging tools or careful inspection; then, either initialize the object before its use or add a null check (e.g., using `if (object != null)`) to prevent accessing it if it's null.
MainFileEvaluationError1 reportThe "MainFileEvaluationError" in Nx often arises from issues with module resolution, especially when using non-standard file extensions or paths without specifying them in your TypeScript or Storybook configuration. To fix it, ensure all imported files (e.g., extensionless TypeScript files or those with custom extensions) are properly resolved by configuring `tsconfig.json` (including `compilerOptions.paths`, `compilerOptions.baseUrl`), or updating Storybook's `webpackFinal` configuration to include the necessary resolvers and loaders for those file types. Consider adding `@nx/js:tsc` executor in the target configuration, specifying the `tsConfig` option to ensure proper TS compilation before other tasks are run.
ModelBuilderException1 reportModelBuilderException in nx often arises when the workspace graph is inconsistent with the physical project structure or when dependencies are improperly defined, especially in Maven projects. Ensure that your `nx.json` and `project.json` files accurately reflect project dependencies and that `pom.xml` files are correctly structured with proper parent-child relationships declared and reachable within the workspace. Run `nx graph` or `nx dep-graph` to visually inspect the dependency graph and identify inconsistencies; then, correct the relevant configuration files.
FailedToResolvePathError1 reportThis error often arises when Nx tasks use paths that are no longer valid due to changes in dependencies or project structure. To fix it, carefully examine your task configurations (project.json or target defaults) and update any file paths, especially those related to generated files or node_modules, to reflect the current project layout after the updates that triggered the error. Running `nx reset` may also clean up cached artifacts causing path resolution issues.
Related Dev Tools Packages
Empowering everyone to build reliable and efficient software.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
Next generation frontend tooling. It's fast!
An extremely fast Python package and project manager, written in Rust.
A bundler for javascript and friends. Packs many modules into a few bundled assets. Code Splitting allows for loading parts of the application on demand. Through "loaders", modules can be CommonJs, AMD, ES6 modules, CSS, Images, JSON, Coffeescript, LESS, ... and your custom stuff.
Subscribe to Updates
Get notified when new versions are released