feat: Nx 21+ (#83)

Author: NathanWalker

.gitignore

@@ -43,3 +43,5 @@ Thumbs.db
 .nx/workspace-data
 .angular
 .env
+.cursor/rules/nx-rules.mdc
+.github/instructions/nx.instructions.md

migrations.json

@@ -1,42 +1,62 @@
 {
   "migrations": [
     {
-      "version": "20.2.0-beta.5",
-      "description": "Update TypeScript ESLint packages to v8.13.0 if they are already on v8",
-      "implementation": "./src/migrations/update-20-2-0/update-typescript-eslint-v8-13-0",
-      "package": "@nx/eslint",
-      "name": "update-typescript-eslint-v8.13.0"
+      "version": "21.0.0-beta.8",
+      "description": "Removes the legacy cache configuration from nx.json",
+      "implementation": "./src/migrations/update-21-0-0/remove-legacy-cache",
+      "package": "nx",
+      "name": "remove-legacy-cache"
     },
     {
-      "version": "20.3.0-beta.1",
-      "description": "Update ESLint flat config to include .cjs, .mjs, .cts, and .mts files in overrides (if needed)",
-      "implementation": "./src/migrations/update-20-3-0/add-file-extensions-to-overrides",
-      "package": "@nx/eslint",
-      "name": "add-file-extensions-to-overrides"
+      "version": "21.0.0-beta.8",
+      "description": "Removes the legacy cache configuration from nx.json",
+      "implementation": "./src/migrations/update-21-0-0/remove-custom-tasks-runner",
+      "package": "nx",
+      "name": "remove-custom-tasks-runner"
     },
     {
-      "cli": "nx",
-      "version": "20.2.0-beta.2",
-      "description": "Update the ModuleFederationConfig import use @nx/module-federation.",
-      "factory": "./src/migrations/update-20-2-0/migrate-mf-imports-to-new-package",
-      "package": "@nx/angular",
-      "name": "update-20-2-0-update-module-federation-config-import"
+      "version": "21.0.0-beta.11",
+      "description": "Updates release version config based on the breaking changes in Nx v21",
+      "implementation": "./src/migrations/update-21-0-0/release-version-config-changes",
+      "package": "nx",
+      "name": "release-version-config-changes"
+    },
+    {
+      "version": "21.0.0-beta.11",
+      "description": "Updates release changelog config based on the breaking changes in Nx v21",
+      "implementation": "./src/migrations/update-21-0-0/release-changelog-config-changes",
+      "package": "nx",
+      "name": "release-changelog-config-changes"
+    },
+    {
+      "version": "21.1.0-beta.2",
+      "description": "Adds **/nx-rules.mdc and **/nx.instructions.md to .gitignore if not present",
+      "implementation": "./src/migrations/update-21-1-0/add-gitignore-entry",
+      "package": "nx",
+      "name": "21-1-0-add-ignore-entries-for-nx-rule-files"
     },
     {
       "cli": "nx",
-      "version": "20.2.0-beta.2",
-      "description": "Update the withModuleFederation import use @nx/module-federation/angular.",
-      "factory": "./src/migrations/update-20-2-0/migrate-with-mf-import-to-new-package",
-      "package": "@nx/angular",
-      "name": "update-20-2-0-update-with-module-federation-import"
+      "version": "21.0.0-beta.9",
+      "description": "Replace usage of `getJestProjects` with `getJestProjectsAsync`.",
+      "implementation": "./src/migrations/update-21-0-0/replace-getJestProjects-with-getJestProjectsAsync",
+      "package": "@nx/jest",
+      "name": "replace-getJestProjects-with-getJestProjectsAsync-v21"
+    },
+    {
+      "version": "21.0.0-beta.10",
+      "description": "Remove the previously deprecated and unused `tsConfig` option from the `@nx/jest:jest` executor.",
+      "implementation": "./src/migrations/update-21-0-0/remove-tsconfig-option-from-jest-executor",
+      "package": "@nx/jest",
+      "name": "remove-tsconfig-option-from-jest-executor"
     },
     {
       "cli": "nx",
-      "version": "20.3.0-beta.2",
-      "description": "If workspace includes Module Federation projects, ensure the new @nx/module-federation package is installed.",
-      "factory": "./src/migrations/update-20-3-0/ensure-nx-module-federation-package",
+      "version": "21.0.0-beta.3",
+      "description": "Set the `continuous` option to `true` for continuous tasks.",
+      "factory": "./src/migrations/update-21-0-0/set-continuous-option",
       "package": "@nx/angular",
-      "name": "ensure-nx-module-federation-package"
+      "name": "set-continuous-option"
     }
   ]
 }

nx.json

@@ -41,6 +41,5 @@
   },
   "parallel": 1,
   "useInferencePlugins": false,
-  "defaultBase": "main",
-  "useLegacyCache": true
+  "defaultBase": "main"
 }

package.json

@@ -32,16 +32,16 @@
   "private": true,
   "devDependencies": {
     "@angular-devkit/core": "~19.2.0",
-    "@nx/angular": "20.8.1",
-    "@nx/devkit": "20.8.1",
-    "@nx/eslint": "20.8.1",
-    "@nx/eslint-plugin": "20.8.1",
-    "@nx/express": "20.8.1",
-    "@nx/jest": "20.8.1",
-    "@nx/js": "20.8.1",
-    "@nx/plugin": "20.8.1",
-    "@nx/web": "20.8.1",
-    "@nx/workspace": "20.8.1",
+    "@nx/angular": "21.1.2",
+    "@nx/devkit": "21.1.2",
+    "@nx/eslint": "21.1.2",
+    "@nx/eslint-plugin": "21.1.2",
+    "@nx/express": "21.1.2",
+    "@nx/jest": "21.1.2",
+    "@nx/js": "21.1.2",
+    "@nx/plugin": "21.1.2",
+    "@nx/web": "21.1.2",
+    "@nx/workspace": "21.1.2",
     "@types/fs-extra": "^11.0.3",
     "@types/jest": "29.5.13",
     "@types/node": "^20.0.0",
@@ -57,7 +57,7 @@
     "fast-xml-parser": "^4.5.0",
     "fs-extra": "^11.2.0",
     "jest": "29.7.0",
-    "nx": "20.8.1",
+    "nx": "21.1.2",
     "nx-cloud": "19.1.0",
     "plist": "^3.1.0",
     "prettier": "^3.3.0",

packages/nx/package.json

@@ -43,10 +43,10 @@
     "plist": "^3.1.0"
   },
   "peerDependencies": {
-    "@nx/devkit": "^20.0.0",
-    "@nx/eslint": "^20.0.0",
-    "@nx/js": "^20.0.0",
-    "@nx/workspace": "^20.0.0",
-    "nx": "^20.0.0"
+    "@nx/devkit": "^21.0.0",
+    "@nx/eslint": "^21.0.0",
+    "@nx/js": "^21.0.0",
+    "@nx/workspace": "^21.0.0",
+    "nx": "^21.0.0"
   }
 }

packages/nx/src/utils/versions.ts

@@ -1,6 +1,6 @@
-export const nxVersion = '^20.0.0';
+export const nxVersion = '^21.0.0';
 
-export const nsNxPluginVersion = '^20.0.0';
+export const nsNxPluginVersion = '^21.0.0';
 export const nsCoreVersion = '~8.9.0';
 export const nsTypesVersion = '~8.9.0';
 export const nsWebpackVersion = '~5.0.0';