@nx/next - Migrations

The @nx/next plugin provides various migrations to help you migrate to newer versions of next projects within your Nx workspace. Below is a complete reference for all available migrations.

23.0.x

update-23-0-0-migrate-create-nodes-v2-import

Version: 23.0.0-beta.24

Rename imports of createNodesV2 from @nx/next/plugin to the canonical createNodes export.

Rename createNodesV2 imports to createNodes

@nx/next renamed its primary inferred-plugin export from createNodesV2 to createNodes. The createNodesV2 name is preserved as a deprecated alias for now, but new code should use createNodes.

This migration scans every .ts, .tsx, .cts, and .mts file in your workspace and rewrites named imports and re-exports of createNodesV2 from @nx/next/plugin to createNodes.

Sample Code Changes

Before

import { createNodesV2 } from '@nx/next/plugin';

After

import { createNodes } from '@nx/next/plugin';

Aliases are preserved (createNodesV2 as cn becomes createNodes as cn), and if a file already imports both names ({ createNodes, createNodesV2 }) the redundant binding is dropped.

What is not rewritten

Only static import/export named bindings from @nx/next/plugin are rewritten. Namespace imports, dynamic import(...), require(...) destructuring, and property access such as plugin.createNodesV2 are left untouched — they keep working through the createNodesV2 runtime alias. Update those by hand if you want to drop the deprecated name everywhere.

22.6.x

22.6.0-package-updates

Version: 22.6.0-beta.10

Packages

The following packages will be updated:

Name	Version	Always add to package.json
next	~16.1.6	Updated only
eslint-config-next	^16.1.6	Updated only

22.2.x

update-22-2-0-create-ai-instructions-for-next-16

Version: 22.2.0-beta.1

Create AI Instructions to help migrate users workspaces to Next.js 16.

Requires

Name	Version
next	>=16.0.0

22.2.0-beta.1-package-updates

Version: 22.2.0-beta.1

Packages

The following packages will be updated:

Name	Version	Always add to package.json
next	~16.0.1	Updated only
eslint-config-next	^16.0.1	Updated only

22.0.x

update-22-0-0-add-svgr-to-next-config

Version: 22.0.0-beta.0

Updates next.config.js files to add SVGR webpack configuration directly instead of using the nx.svgr option in withNx.