migrations.json

{
  "migrations": [
    {
      "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.6",
      "description": "Rewrite imports from `@nx/devkit/src/...` to `@nx/devkit` (for public symbols) or `@nx/devkit/internal` (for the rest), since deep imports are no longer reachable through the package's `exports` map.",
      "implementation": "./dist/src/migrations/update-23-0-0/update-deep-imports",
      "documentation": "./dist/src/migrations/update-23-0-0/update-deep-imports.md",
      "package": "@nx/devkit",
      "name": "update-devkit-deep-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename deprecated CreateNodes `V2` type imports (CreateNodesV2, CreateNodesContextV2, CreateNodesResultV2, CreateNodesFunctionV2, NxPluginV2) from `@nx/devkit` to their canonical names.",
      "implementation": "./dist/src/migrations/update-23-0-0/rename-create-nodes-v2-types",
      "documentation": "./dist/src/migrations/update-23-0-0/rename-create-nodes-v2-types.md",
      "package": "@nx/devkit",
      "name": "update-23-0-0-rename-create-nodes-v2-types"
    },
    {
      "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": "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.1.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.1.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.1.0/ai-instructions-for-vitest-4.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": "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.1.0-beta.8",
      "description": "Adds `\"ignoreDeprecations\": \"6.0\"` to tsconfig files whose compilerOptions (or ts-node.compilerOptions) carry a TypeScript 6 deprecated option value, set directly or inherited through `extends` including from a base this migration does not edit (e.g. moduleResolution node/node10/classic, baseUrl, target es5, esModuleInterop false, outFile, module amd/umd/system/none, alwaysStrict false, allowSyntheticDefaultImports false, downlevelIteration set). Also pins `\"strict\": false`, `\"noUncheckedSideEffectImports\": false`, `\"types\": [\"*\"]`, and `\"esModuleInterop\": false` in chain-root tsconfigs (no \"extends\") that lack each key, preserving pre-TS6 behavior where these defaults changed; `esModuleInterop` false is itself deprecated (removed in TS7) so it also receives `ignoreDeprecations`, deferring the interop change to the TS7 migration. Also adds `ignoreDeprecations` to every `tsconfig.json` (the exact name jest/ts-node auto-resolve when compiling a config file; ts-node injects a deprecated default `target: es5` there, so the load hits a TS6 error even on a clean config), even one with no deprecated value of its own; a stale local `ignoreDeprecations` (e.g. `5.0`) that would otherwise override the inherited flag is upgraded.",
      "requires": {
        "typescript": ">=6.0.0"
      },
      "factory": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6",
      "documentation": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.md",
      "package": "@nx/js",
      "name": "23-1-0-add-ignore-deprecations-for-ts6"
    },
    {
      "version": "23.1.0-rc.2",
      "description": "Sets an explicit `rootDir` on project `tsconfig*.json` files that lack one, pinned to the source directory TypeScript 5 inferred implicitly, so programs keep compiling and emitting the same layout under TypeScript 6, which otherwise hard-fails with TS5011 or TS6059 (for example a spec tsconfig importing another project's source through a `paths` alias). The pin is written even when the inferred directory already equals the tsconfig directory, because tools like ts-jest with `isolatedModules` compile a program per file and re-infer a deeper directory from that subset. The value is computed by the compiler, so emit layout is unchanged. Each config is written on its own; the migration never writes to a shared `extends` base, so a config never inherits a value computed for a sibling. Composite projects are pinned to their own directory: `rootDir` already defaults there under `tsc` so it is a no-op for a real composite build, but ts-jest strips `composite` for its per-file transpile and the explicit value is needed to avoid TS5011 there.",
      "requires": {
        "typescript": ">=6.0.0"
      },
      "factory": "./dist/src/migrations/update-23-1-0/set-tsconfig-root-dir-for-ts6",
      "documentation": "./dist/src/migrations/update-23-1-0/set-tsconfig-root-dir-for-ts6.md",
      "package": "@nx/js",
      "name": "23-1-0-set-tsconfig-root-dir-for-ts6"
    },
    {
      "version": "23.0.0-beta.25",
      "description": "Rewrites `@nx/node/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/node`'s exports map. Named imports/exports of public symbols are routed to `@nx/node` and the rest to the new `@nx/node/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/node/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/node",
      "name": "rewrite-node-internal-subpath-imports"
    },
    {
      "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"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/playwright/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/playwright",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "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"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "react": ">=19.0.0"
      },
      "description": "Create AI instructions to help migrate workspaces from React 18 to 19.",
      "prompt": "tools/ai-migrations/@nx/react/23.1.0/ai-instructions-for-react-19.md",
      "documentation": "./dist/src/migrations/update-23-1-0/upgrade-to-react-19.md",
      "package": "@nx/react",
      "name": "update-23-1-0-create-ai-instructions-for-react-19"
    }
  ]
}