migrations.json

{
  "migrations": [
    {
      "version": "22.0.0-beta.1",
      "description": "Updates release version config based on the breaking changes in Nx v22",
      "implementation": "./dist/src/migrations/update-22-0-0/release-version-config-changes",
      "package": "nx",
      "name": "22-0-0-release-version-config-changes"
    },
    {
      "version": "22.0.0-beta.2",
      "description": "Consolidates releaseTag* options into nested releaseTag object structure",
      "implementation": "./dist/src/migrations/update-22-0-0/consolidate-release-tag-config",
      "package": "nx",
      "name": "22-0-0-consolidate-release-tag-config"
    },
    {
      "cli": "nx",
      "version": "22.1.0-beta.5",
      "description": "Updates the nx wrapper.",
      "implementation": "./dist/src/migrations/update-22-1-0/update-nx-wrapper",
      "package": "nx",
      "name": "22-1-0-update-nx-wrapper"
    },
    {
      "cli": "nx",
      "version": "22.6.0-beta.10",
      "description": "Adds .claude/worktrees to .gitignore",
      "implementation": "./dist/src/migrations/update-22-6-0/add-claude-worktrees-to-git-ignore",
      "package": "nx",
      "name": "22-6-1-add-claude-worktrees-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.7.0-beta.0",
      "description": "Adds .nx/polygraph to .gitignore",
      "implementation": "./dist/src/migrations/update-22-7-0/add-polygraph-to-git-ignore",
      "package": "nx",
      "name": "22-7-0-add-polygraph-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.6.0-rc.0",
      "description": "Adds .claude/settings.local.json to .gitignore",
      "implementation": "./dist/src/migrations/update-17-3-0/update-nxw",
      "package": "nx",
      "name": "22-6-0-add-claude-settings-local-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.7.0-beta.0",
      "description": "Adds .nx/self-healing to .gitignore",
      "implementation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore",
      "documentation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore.md",
      "package": "nx",
      "name": "22-7-0-add-self-healing-to-gitignore"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Consolidates any remaining legacy releaseTag* flat properties into the nested releaseTag object. The flat properties were removed in Nx 23.",
      "implementation": "./dist/src/migrations/update-23-0-0/consolidate-release-tag-config",
      "package": "nx",
      "name": "23-0-0-consolidate-release-tag-config"
    },
    {
      "version": "23.0.0-beta.18",
      "description": "Adds .nx/migrate-runs to .gitignore",
      "implementation": "./dist/src/migrations/update-23-0-0/add-migrate-runs-to-git-ignore",
      "package": "nx",
      "name": "23-0-0-add-migrate-runs-to-git-ignore"
    },
    {
      "version": "23.0.0-beta.10",
      "description": "Rewrites imports of `@nx/workspace/src/utilities/typescript/compilation` to `@nx/js/internal`, where the module now lives.",
      "implementation": "./dist/src/migrations/update-23-0-0/move-typescript-compilation-import",
      "package": "@nx/workspace",
      "name": "23-0-0-move-typescript-compilation-import"
    },
    {
      "version": "22.0.0-beta.0",
      "description": "Remove the deprecated `external` and `externalBuildTargets` options from the `@nx/js:swc` and `@nx/js:tsc` executors.",
      "factory": "./dist/src/migrations/update-22-0-0/remove-external-options-from-js-executors",
      "documentation": "./dist/src/migrations/update-22-0-0/remove-external-options-from-js-executors.md",
      "package": "@nx/js",
      "name": "remove-external-options-from-js-executors"
    },
    {
      "version": "22.1.0-rc.1",
      "description": "Removes redundant TypeScript project references from project's tsconfig.json files when runtime tsconfig files (e.g., tsconfig.lib.json, tsconfig.app.json) exist.",
      "factory": "./dist/src/migrations/update-22-1-0/remove-redundant-ts-project-references",
      "documentation": "./dist/src/migrations/update-22-1-0/remove-redundant-ts-project-references.md",
      "package": "@nx/js",
      "name": "remove-redundant-ts-project-references"
    },
    {
      "version": "23.0.0-beta.14",
      "description": "Rewrites `@nx/js/src/*` subpath imports to the new `@nx/js/internal` entry. The `./src/*` wildcard has been removed from `@nx/js`'s exports map; `@nx/js/src/release/version-actions` is preserved as a non-wildcard entry for back-compat with existing nx.json release configs. If a rewritten import resolves to a symbol that lives on the public `@nx/js` entry (e.g. `libraryGenerator`, `extractTsConfigBase`, `resolvePathsBaseUrl`), change the specifier to `@nx/js`.",
      "factory": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/js",
      "name": "23-0-0-rewrite-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/js/typescript` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/js",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.0.0-beta.25",
      "description": "Rewrites `@nx/web/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/web`'s exports map. Named imports/exports of public symbols are routed to `@nx/web` and the rest to the new `@nx/web/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/web/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/web",
      "name": "rewrite-web-internal-subpath-imports"
    },
    {
      "cli": "nx",
      "version": "22.1.0-beta.8",
      "requires": {
        "storybook": ">=10.0.0"
      },
      "description": "Update workspace to use Storybook v10",
      "implementation": "./dist/src/migrations/update-22-1-0/migrate-to-storybook-10",
      "prompt": "tools/ai-migrations/@nx/storybook/23.0.0/ai-instructions-for-cjs-esm.md",
      "package": "@nx/storybook",
      "name": "update-22-1-0-migrate-storybook-v10"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/storybook/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/storybook",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "22.2.0-beta.1",
      "requires": {
        "vitest": ">=4.0.0"
      },
      "description": "Create AI Instructions to help migrate users workspaces past breaking changes for Vitest 4.",
      "prompt": "tools/ai-migrations/@nx/vite/23.0.0/ai-instructions-for-vitest-4.md",
      "package": "@nx/vite",
      "name": "update-22-2-0"
    },
    {
      "version": "22.2.0-beta.2",
      "description": "Migrate Vitest usage from @nx/vite to @nx/vitest package.",
      "implementation": "./dist/src/migrations/update-22-2-0/migrate-vitest-to-vitest-package",
      "package": "@nx/vite",
      "name": "migrate-vitest-to-vitest-package"
    },
    {
      "version": "23.0.0-beta.10",
      "description": "Safety net: ensure any remaining @nx/vite:test executor usages are swapped to @nx/vitest:test and @nx/vitest is installed.",
      "implementation": "./dist/src/migrations/update-23-0-0/ensure-vitest-package-migration",
      "documentation": "./dist/src/migrations/update-23-0-0/ensure-vitest-package-migration.md",
      "package": "@nx/vite",
      "name": "ensure-vitest-package-migration-23"
    },
    {
      "version": "23.0.0-beta.10",
      "requires": {
        "vite": ">=8.0.0"
      },
      "description": "Rename `rollupOptions` to `rolldownOptions` in vite config files (top-level and inside `environments`). Vite 8 replaced Rollup with Rolldown.",
      "implementation": "./dist/src/migrations/update-23-0-0/rename-rollup-options-to-rolldown-options",
      "documentation": "./dist/src/migrations/update-23-0-0/rename-rollup-options-to-rolldown-options.md",
      "package": "@nx/vite",
      "name": "rename-rollup-options-to-rolldown-options"
    },
    {
      "version": "23.0.0-beta.10",
      "requires": {
        "vite": ">=8.0.0"
      },
      "description": "Create AI Instructions to help migrate users workspaces past breaking changes for Vite 8.",
      "prompt": "tools/ai-migrations/@nx/vite/23.0.0/ai-instructions-for-vite-8.md",
      "package": "@nx/vite",
      "name": "create-ai-instructions-for-vite-8"
    },
    {
      "version": "23.0.0-beta.22",
      "requires": {
        "vitest": ">=3.0.0"
      },
      "description": "Migrate workspaces past breaking changes for Vitest 3.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-to-vitest-3",
      "prompt": "tools/ai-migrations/@nx/vite/23.0.0/ai-instructions-for-vitest-3.md",
      "package": "@nx/vite",
      "name": "migrate-to-vitest-3"
    },
    {
      "version": "23.0.0-beta.22",
      "requires": {
        "vitest": ">=4.0.0"
      },
      "description": "Migrate workspaces past breaking changes for Vitest 4.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-to-vitest-4",
      "prompt": "tools/ai-migrations/@nx/vite/23.0.0/ai-instructions-for-vitest-4-1.md",
      "package": "@nx/vite",
      "name": "migrate-to-vitest-4"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/vite/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/vite",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "22.7.0-beta.12",
      "description": "Add missing inputs to @nx/eslint:lint executor target defaults",
      "implementation": "./dist/src/migrations/update-21-6-0/update-executor-lint-inputs",
      "package": "@nx/eslint",
      "name": "update-executor-lint-inputs"
    },
    {
      "version": "23.0.0-beta.17",
      "description": "Rewrites `@nx/eslint/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/eslint`'s exports map. Named imports/exports of public symbols are routed to `@nx/eslint` and the rest to the new `@nx/eslint/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/eslint/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/eslint",
      "name": "rewrite-eslint-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/eslint/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/eslint",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "22.2.0-beta.2",
      "description": "Convert jest.config.ts files from ESM to CJS syntax (export default -> module.exports, import -> require) for projects using CommonJS resolution to ensure correct loading under Node.js type-stripping.",
      "implementation": "./dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs",
      "documentation": "./dist/src/migrations/update-22-2-0/convert-jest-config-to-cjs.md",
      "package": "@nx/jest",
      "name": "convert-jest-config-to-cjs"
    },
    {
      "version": "22.3.2-beta.0",
      "requires": {
        "jest": ">=30.0.0"
      },
      "description": "Replace removed matcher aliases in Jest v30 with their corresponding matcher",
      "implementation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases",
      "documentation": "./dist/src/migrations/update-21-3-0/replace-removed-matcher-aliases.md",
      "package": "@nx/jest",
      "name": "replace-removed-matcher-aliases-v22-3"
    },
    {
      "version": "23.0.0-beta.10",
      "requires": {
        "jest": ">=30.0.0"
      },
      "description": "Update the Jest snapshot guide link in `.snap` files from the legacy `https://goo.gl/fbAQLP` URL to `https://jestjs.io/docs/snapshot-testing`, which Jest v30 now requires.",
      "implementation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link",
      "documentation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link.md",
      "package": "@nx/jest",
      "name": "update-snapshot-guide-link"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Rewrites `@nx/jest/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/jest`'s exports map. Named imports/exports of public symbols are routed to `@nx/jest` and the rest to the new `@nx/jest/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/jest/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/jest",
      "name": "rewrite-jest-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Replaces the removed `jestProjectGenerator` export from `@nx/jest` with its replacement `configurationGenerator`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-jest-project-generator",
      "package": "@nx/jest",
      "name": "rewrite-jest-project-generator"
    },
    {
      "version": "23.0.0-beta.22",
      "description": "Migrate the deprecated `setupFile` option of the `@nx/jest:jest` executor: push the file path into `setupFilesAfterEnv` in the project's Jest config and remove the option from `project.json` and `nx.json` target defaults.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-executor-setup-file",
      "package": "@nx/jest",
      "name": "migrate-jest-executor-setup-file"
    },
    {
      "version": "23.0.0-beta.22",
      "description": "Migrate the deprecated `skipSetupFile` option of the `@nx/jest:configuration` generator stored as a default in `nx.json` or per-project `project.json` to `setupFile: 'none'` (when `true`) or remove it (when `false`).",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-configuration-skip-setup-file",
      "package": "@nx/jest",
      "name": "migrate-jest-configuration-skip-setup-file"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/jest/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/jest",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "cli": "nx",
      "version": "22.0.0-beta.0",
      "description": "Updates webpack configs using React to use the new withSvgr composable function instead of the svgr option in withReact or NxReactWebpackPlugin.",
      "factory": "./dist/src/migrations/update-22-0-0/add-svgr-to-webpack-config",
      "package": "@nx/react",
      "name": "update-22-0-0-add-svgr-to-webpack-config"
    },
    {
      "cli": "nx",
      "version": "23.0.0-beta.10",
      "description": "Rewrites imports of NxReactWebpackPlugin from '@nx/react' to the sub-path '@nx/react/webpack-plugin'.",
      "factory": "./dist/src/migrations/update-23-0-0/remove-nx-react-webpack-plugin-import",
      "documentation": "./dist/src/migrations/update-23-0-0/remove-nx-react-webpack-plugin-import.md",
      "package": "@nx/react",
      "name": "update-23-0-0-remove-nx-react-webpack-plugin-import"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/react/router-plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/react",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.0.0-beta.25",
      "description": "Rewrites `@nx/react/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/react`'s exports map. Named imports/exports of public symbols are routed to `@nx/react` and the rest to the new `@nx/react/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/react/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/react",
      "name": "rewrite-react-internal-subpath-imports"
    },
    {
      "cli": "nx",
      "version": "22.0.0-beta.0",
      "description": "Updates next.config.js files to add SVGR webpack configuration directly instead of using the nx.svgr option in withNx.",
      "factory": "./dist/src/migrations/update-22-0-0/add-svgr-to-next-config",
      "package": "@nx/next",
      "name": "update-22-0-0-add-svgr-to-next-config"
    },
    {
      "cli": "nx",
      "version": "22.2.0-beta.1",
      "requires": {
        "next": ">=16.0.0"
      },
      "description": "Create AI Instructions to help migrate users workspaces to Next.js 16.",
      "prompt": "tools/ai-migrations/@nx/next/23.0.0/ai-instructions-for-next-16.md",
      "package": "@nx/next",
      "name": "update-22-2-0-create-ai-instructions-for-next-16"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/next/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/next",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    }
  ]
}