TL;DR

Nx now supports agentic migration, allowing for more automated refactoring tasks via nx migrate --run-migrations.

Breaking

• Testing: The skipSetupFile and setupFile options are removed from the @nx/jest executor and generator.
• Vite: The nxViteTsPaths and nxCopyAssetsPlugin helpers are deprecated.

New

• Module Federation: New generators are available for creating module federation consumers and providers.
• Migration: Nx migrate now supports an agentic mode for automated refactoring.

Fixes Worth Knowing

• Angular projects now align with Angular v21 by updating zoneJsVersion to ~0.16.0.
• Fixed an issue where affected detection was failing with non-pnpm lock files.
• Security vulnerability addressed by updating the tmp dependency.

TL;DR

Nx now includes updated dependencies, resolving a potential security vulnerability and ensuring compatibility with newer tooling.

Fixes Worth Knowing

Updated core dependencies (brace-expansion, yaml) to address potential security issues and maintain compatibility.

TL;DR

Nx now supports Vite 8 for React Router apps and includes significant performance improvements, particularly for nx version and on aarch64 Linux systems, alongside numerous bug fixes across core functionality and plugins.

Fixes Worth Knowing

• nx version is now significantly faster.
• Resolved a crash on aarch64 Linux systems with specific kernel configurations.
• Improved handling of build output directories for Node executors.
• Corrected issues with workspace lockfile pruning when using npm workspaces.
• Fixed problems with task hashing and input/output recognition for TypeScript and Gradle projects.

Before You Upgrade

If you are on aarch64 Linux, this release addresses a potential crash and is recommended.

TL;DR

Nx now correctly tracks task outputs regardless of file path depth, improving reliability when using complex project structures.

Fixes Worth Knowing

Task output tracking is more robust, resolving issues where outputs in deeply nested directories weren’t being correctly identified by Nx (build system).

Before You Upgrade

No action is needed to upgrade.

TL;DR

Nx now correctly handles variable references within linter overrides, preventing unexpected linting errors.

Fixes Worth Knowing

Linting now accurately processes variable references in custom override configurations, resolving issues where valid code was incorrectly flagged.

Before You Upgrade

No action is needed; this is a bug fix release.

TL;DR

Nx now supports configuring AI agents (software assistants) directly from the command line, streamlining automation and development workflows.

New

• AI Agent Configuration: A new configure-ai-agents command simplifies setting up AI-powered tools within your Nx workspace.
• Improved Task Lifecycle: Lifecycle hooks now include id, start, and end times for better task monitoring.
• Gradle Support: Split targets now support the Gradle build system.

Fixes Worth Knowing

• Prettier Errors: Prettier errors are now displayed correctly.
• Windows Support: Improved compatibility with Windows environments for core commands.
• React Router Plugin: The React Router plugin is only added when actually using React Router.

Before You Upgrade

If you are using Nx Cloud with an OSS plan, ensure you are redirected correctly to the form after login.

TL;DR

Nx now supports the rspack bundler (build tool) alongside Webpack and Vite, offering potential performance improvements and new features like HTTP caching.

Breaking

None.

New

• Rspack Support: Add rspack as a bundler option for Angular projects and core Nx functionality.
• HTTP Caching: Introduce support for HTTP-based caches to speed up builds.
• Yarn Resolution Handling: Improved handling of yarn resolutions and patches for more reliable dependency management.

Fixes Worth Knowing

• TypeScript Configuration: Correctly handles changes to tsconfig files, avoiding unnecessary rebuilds.
• Webpack Compatibility: Locked webpack version for compatibility with @angular-devkit.
• Cypress Support: Updated to support Cypress v14 (testing framework).

Before You Upgrade

If you are using Yarn, ensure your yarn.lock file is up-to-date before upgrading to benefit from the improved resolution handling.

TL;DR

Nx now caches the dependency graph in CI (Continuous Integration) environments, significantly speeding up builds and reducing resource consumption.

Fixes Worth Knowing

Builds in CI pipelines are now faster due to dependency graph caching.

Before You Upgrade

Ensure your CI environment has sufficient disk space to accommodate the cached graph.

TL;DR

Nx now integrates with Nx Powerpack (a suite of tools for extending Nx) and improves project import functionality, streamlining workspace configuration and management.

Breaking

None.

New

• Nx Powerpack Integration: Adds support for utilizing Nx Powerpack features.
• Gradle Project Import: Enables importing Gradle (build automation tool) projects into Nx workspaces.
• Inferred Configuration: Introduces a metagenerator for converting to inferred configurations.

Fixes Worth Knowing

• Module Federation: Corrects issues with dynamic module federation and project name normalization.
• Workspace Creation: Handles cases where Prettier (code formatter) is not installed during workspace creation.
• Import Process: Improves the reliability and rebasability of the nx import command, including better argument escaping on Windows.

Before You Upgrade

If you are using Nx Cloud, ensure your Nx Cloud connection URLs are still valid after upgrading.

TL;DR

Nx now correctly detects project dependencies when using named inputs, ensuring builds and tests run as expected with complex configurations.

Fixes Worth Knowing

• Corrected dependency detection for projects using named inputs (explicitly defined project inputs).

Before You Upgrade

• Clear your Nx cache (nx reset) if you experience unexpected behavior after upgrading, particularly with projects using named inputs.

TL;DR

Nx now ensures compatibility with older projects by importing RxJS operators (reactive programming library) from rxjs/operators, resolving potential build errors after upgrading.

Fixes Worth Knowing

• Angular: Projects using older RxJS versions should now build without modification.
• Core: Changelog generation is more reliable.

Before You Upgrade

No action is needed; this release contains compatibility and reliability improvements.

TL;DR

Nx now loads .env files from the root of your project, simplifying environment variable management for all projects within the workspace.

Breaking

None.

New

• SWC Options: Added support for --strip-leading-paths when using SWC (fast JavaScript/TypeScript compiler).
• Jest Test Splitting: You can now split Jest tests into smaller, more manageable chunks.
• Playwright Metadata: Playwright targets now include metadata for improved reporting and integration.

Fixes Worth Knowing

• Angular Generators: Corrected how skipPackageJson is handled, ensuring accurate project setup.
• CI Detection: Improved isCI detection to work with a wider range of continuous integration providers.
• Rollup Errors: Rollup build errors are now displayed correctly.
• React Native: Improved app name prompting and Windows compatibility.

Before You Upgrade

None.

TL;DR

Nx now supports Angular 17.1.0 and improves the developer experience with better CI workflows, project graph visibility after initialization, and more robust command execution.

Breaking

None.

New

• Angular 17.1 Support: Adds compatibility with the latest Angular version.
• Improved CI Workflows: Nx generates more effective CI (Continuous Integration) configurations.
• Project Graph Visibility: Nx now guides users to the project graph after nx init (visual dependency map).

Fixes Worth Knowing

• Reliable Command Execution: Fixes issues with sending signals to child processes and handling arguments, improving the reliability of Nx commands.
• Release Improvements: Several fixes to the release tooling, including handling of changelogs and project publishing.
• Plugin Support: Fixes for various plugins including Angular, Cypress, Expo, Nuxt, Remix, Storybook, and Vite.

Before You Upgrade

If you are using Angular, ensure your project is compatible with version 17.1.0 before upgrading Nx.

TL;DR

Nx now supports incremental TypeScript semantic diagnostics in Angular projects using ng-packagr, improving build performance for larger codebases.

Breaking

• No breaking changes.

New

• Angular: Faster builds with incremental TypeScript diagnostics.
• Vue: A Storybook configuration generator is now available.

Fixes Worth Knowing

• Angular: Resolved issues with component generation, library generation, and route configuration.
• Core: Improved project pattern matching and task caching.
• Linter: Fixed rule typings and added schema for plugin checks.

Before You Upgrade

• No action needed.

TL;DR

Nx now uses an offline-first approach for generating changelogs (release notes), improving reliability and speed.

Breaking

[None]

New

• React: Webpack configuration files are now supported for module federation (sharing code between applications).
• Angular: Incremental TypeScript semantic diagnostics are now available with ng-packagr executors, speeding up builds.
• AI Chat: A link to the AI Chat beta (conversational AI assistant) is now available in the documentation header.

Fixes Worth Knowing

• Angular: Fixed an issue causing duplicate route configurations when generating libraries.
• Core: Improved how project matching works with include/exclude patterns for more intuitive behavior.

Before You Upgrade

No specific action is needed.

TL;DR

Nx now correctly handles patch version updates, resolving issues with dependency resolution and ensuring consistent builds.

Breaking

• No breaking changes.

New

• No new features.

Fixes Worth Knowing

• Dependency versioning is now more reliable, preventing unexpected build failures.

Before You Upgrade

• No action needed.

TL;DR

Nx now supports creating Node projects without a JavaScript framework, offering greater flexibility for backend and tooling projects.

Breaking

• No breaking changes in these releases.

New

• Node Projects: You can now create Node projects with --framework=none when using create-nx-workspace.
• Vite: The Vite build executor now supports an outfile option for specifying a single output file.
• Testing: New generator for Cypress E2E configuration.

Fixes Worth Knowing

• Angular: Fixed issues with component generation, migrations, and prettier integration.
• Next.js: Several fixes related to production server configuration and dependency management.
• Core: Improved project graph analysis and npm pruning.

Before You Upgrade

• If you're using Next.js, be aware that the proxy config option for the server executor is now deprecated.

TL;DR

Nx now correctly identifies changes when files are renamed, improving the accuracy of affected commands (commands showing project dependencies).

Breaking

None

New

None

Fixes Worth Knowing

• Affected Commands: File renames are now correctly detected, ensuring nx affected and similar commands show the correct dependencies.
• JSON Diffing: Improved how Nx compares JSON files during merges, resolving issues with change detection.

Before You Upgrade

None

TL;DR

Nx now supports Vite 2.9, enabling faster build times and a better developer experience when using this modern frontend (build tool).

Breaking

• The minimum required Node.js version is now 14.15.0 (JavaScript runtime).
• nx format:write now uses prettier directly, removing the old Nx format cache (formatting tool).

New

• Added experimental support for running tasks in parallel, significantly speeding up Nx workflows (task execution).

Fixes Worth Knowing

• Fixed an issue where Nx Cloud caching could fail intermittently with certain project configurations (CI/CD platform).

Before You Upgrade

• Ensure your Node.js version is 14.15.0 or higher.

TL;DR

Nx now supports optional workspace.json files, offering a more flexible workspace configuration alongside nx.json.

Breaking

• Web: The @nrwl/web:build executor has been renamed to @nrwl/web:webpack.
• Web: The package executor has been renamed to rollup.

New

• Core: Nx workspaces can now be configured with an optional workspace.json file.
• Angular: Tailwind CSS support has been added for buildable libraries.
• Dependency Graph: You can now download an image of your dependency graph.

Fixes Worth Knowing

• Angular: Corrected issues with type definitions, package entry points, and Sass imports.
• Core: Fixed a stack overflow error when using standalone configurations with many projects.
• Linter: Improved linting to respect folder configurations and allow banning transitive dependencies.

Before You Upgrade

• If you're using @nrwl/web:build, update your Nx configuration to use @nrwl/web:webpack instead.
• If you're using the package executor, update your Nx configuration to use rollup instead.

TL;DR

Nx now handles very large workspaces (600+ projects) without crashing, resolving a stack overflow issue when using standalone configurations.

Fixes Worth Knowing

Fixed a crash when working with Nx workspaces containing a large number of projects, especially when using standalone configurations (custom Nx setups).

Before You Upgrade

No action needed – this release contains a bug fix and should be a seamless upgrade.

TL;DR

Nx now supports Webpack 5 and Next.js 11, improving build performance and enabling access to the latest features in those ecosystems.

Breaking

• No breaking changes.

New

• Webpack 5 Support: Nx projects can now migrate to and utilize Webpack 5 for faster builds.
• Next.js 11 Support: Updated to support the latest Next.js version.
• Batch Executors: Improved task execution with batching for faster operation.

Fixes Worth Knowing

• Fixed issues with project configuration detection and dependency handling, improving project setup and task execution reliability.
• Resolved problems with asset copying during watch mode builds for Node projects.
• Corrected issues with the dependency graph and tag generation in the Nx repository.

Before You Upgrade

• If upgrading to Webpack 5, review your existing Webpack configurations for compatibility.

TL;DR

Nx now correctly handles workspaces hosted at the root directory (/) and allows specifying a path when reading workspace configuration, improving flexibility for complex setups.

Breaking

• Generating a new Nx workspace into a non-empty directory will now error (prevents accidental overwrites).

New

• Workspace Configuration Path: You can now specify a path when reading the workspace configuration file.

Fixes Worth Knowing

• Building workspaces hosted at the root directory now works as expected.
• React library publishing now correctly copies the README file.
• Storybook (UI component explorer) now uses the correct environment in development mode.

Before You Upgrade

Ensure any new workspace generation targets an empty directory to avoid errors.

TL;DR

Nx now correctly resolves project dependencies with relative imports on Windows, improving the development experience for users on that platform.

Fixes Worth Knowing

• Relative imports now work as expected in Windows filepaths.
• Git hashing is more reliable when projects are nested within workspaces, and correctly identifies deleted files.

Before You Upgrade

No specific action is needed to benefit from these fixes.

TL;DR

Nx now correctly resolves imports and handles terminal output for failed tasks, improving the reliability of builds and debugging.

Fixes Worth Knowing

• Import resolution is improved for TypeScript projects.
• Terminal output is now captured even when tasks fail (command-line interface).
• --all=true is now a valid flag alongside --all.

Before You Upgrade

No specific action is needed for this upgrade.

TL;DR

Nx now includes Node.js version and OS in its build cache keys, improving cache hit rates and build performance.

New

• Improved Build Caching: Nx now considers Node.js version and operating system when creating build caches (runtimeCacheInputs).
• Faster Project Hashing: Project source hashing is now memoized for quicker dependency analysis.

Fixes Worth Knowing

• Fixed issues with file changes and deletions being detected correctly.
• Corrected task ordering in the console output.
• Improved JSON diffing for more accurate change detection.

Before You Upgrade

No specific action is needed for this upgrade.

TL;DR

Nx now supports Angular 9 and includes significant improvements to the build cache, making development faster.

Breaking

• Angular/NgRx: Default schematics now use creator functions instead of actions, and data persistence is disabled by default. This affects generated code for new NgRx features.

New

• Angular 9 Support: Nx now fully supports Angular 9, including updates to related tooling.
• Build Cache Improvements: Minor cache improvements enhance development ergonomics.

Fixes Worth Knowing

• NgRx Schematics: Updated defaults for NgRx schematics.
• nx migrate: Corrected issues with duplicate dependencies and schematic execution.
• ng add: Fixed paths for adding workspace packages.

Before You Upgrade

Review your NgRx configurations if you’re starting new features, as the default schematics have changed.

TL;DR

Nx now allows using interpolated arguments with the affected command, making it easier to dynamically target projects for builds and tests.

New

• You can now use interpolated arguments in the affected command (command-line tool for running tasks on changed projects).
• The run-commands builder (task runner) now supports passing arguments.

Fixes Worth Knowing

• Fixed issues with TypeScript path resolution in frontend projects.
• Improved updating from Nx v6 to v8.
• Corrected project ordering for affected:build --all.

Before You Upgrade

No specific action is needed for this upgrade.

TL;DR

Nx now uses updated dependencies, improving security and stability for your projects.

Breaking

• Security Update: Removed a dependency (event-stream) with known vulnerabilities.

Fixes Worth Knowing

• Updated npm-run-all (task runner) to resolve potential issues with parallel task execution.

Before You Upgrade

• No specific action needed; this is a dependency update.

TL;DR

Nx now supports generating new applications with Jest (testing framework) unit tests, and provides more control over Jest execution with new builder options.

New

• Generate applications with Jest unit tests.
• Control Jest execution with bail, silent, runInBand, and maxWorkers options.

Fixes Worth Knowing

• Fixes to schematics (code generation tools) prevent unintended modifications to test files and improve path handling.
• The checkcommit script now allows release commits.

TL;DR

Nx now supports Angular CLI version 6, improving compatibility and enabling access to the latest Angular features.

Breaking

• CLI Version: Requires Angular CLI 6 (command-line interface)

New

• Affected Tests: The affected:test schematic (a code generation tool) now allows you to run tests only for projects impacted by your changes.

Fixes Worth Knowing

• Workspace Creation: Corrected missing dependencies when creating new Nx workspaces.
• Library Schematic: Libraries are now created with the correct npm scope (package naming).

Before You Upgrade

Update your global Angular CLI to version 6 (npm install -g @angular/cli@6).

TL;DR

Nx now automatically adds a tsconfig.tools.json file during schematic migrations, improving TypeScript (a JavaScript variant) build tooling.

Breaking

• None

New

• None

Fixes Worth Knowing

• Build scripts now correctly pass options to packages.
• Schematic parallelization respects the parallel setting.

Before You Upgrade

• No action needed.

TL;DR

Nx now supports TypeScript 3.0, improving developer experience with the latest language features and type safety.

Breaking

• Removed support for Node versions older than 8 (minimum required version).
• Updated @nrwl/tao to require a workspace.json file (defines project configuration).

New

• Added experimental support for creating applications with React (JavaScript library for building UIs).
• Improved caching for build tasks, speeding up development workflows.

Fixes Worth Knowing

• Fixed an issue where Nx would sometimes incorrectly detect changes.

Before You Upgrade

• Ensure your Node.js version is 8 or higher.
• Migrate your project configuration to use a workspace.json file.