feat: add a codemod to migrate from the deprecated "next lint" command

Author: bgub

docs/01-app/02-guides/upgrading/codemods.mdx

@@ -24,6 +24,78 @@ Replacing `<transform>` and `<path>` with appropriate values.
 
 ## Codemods
 
+### 16.0
+
+#### Migrate from `next lint` to explicit ESLint configuration
+
+##### `next-lint-to-explicit-eslint`
+
+```bash filename="Terminal"
+npx @next/codemod@latest next-lint-to-explicit-eslint .
+```
+
+This codemod migrates projects from using `next lint` to explicit ESLint configuration files. It:
+
+- Creates an `eslint.config.mjs` file with Next.js recommended configurations
+- Updates package.json scripts to use `eslint .` instead of `next lint`
+- Adds necessary ESLint dependencies to package.json
+- Preserves existing ESLint configurations when found
+
+For example:
+
+```json filename="package.json"
+{
+  "scripts": {
+    "lint": "next lint"
+  }
+}
+```
+
+Becomes:
+
+```json filename="package.json"
+{
+  "scripts": {
+    "lint": "eslint ."
+  },
+  "devDependencies": {
+    "eslint": "^9",
+    "eslint-config-next": "latest",
+    "@eslint/eslintrc": "^3"
+  }
+}
+```
+
+And creates:
+
+```js filename="eslint.config.mjs"
+import { dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { FlatCompat } from '@eslint/eslintrc'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+})
+
+const eslintConfig = [
+  ...compat.extends('next/core-web-vitals', 'next/typescript'),
+  {
+    ignores: [
+      'node_modules/**',
+      '.next/**',
+      'out/**',
+      'build/**',
+      'next-env.d.ts',
+    ],
+  },
+]
+
+export default eslintConfig
+```
+
 ### 15.0
 
 #### Transform App Router Route Segment Config `runtime` value from `experimental-edge` to `edge`

packages/next-codemod/bin/transform.ts

@@ -113,6 +113,11 @@ export async function runTransform(
     return require(transformerPath).default(filesExpanded, options)
   }
 
+  if (transformer === 'next-lint-to-explicit-eslint') {
+    // next-lint-to-explicit-eslint transform doesn't use jscodeshift directly
+    return require(transformerPath).default(filesExpanded, options)
+  }
+
   let args = []
 
   const { dry, print, runInBand, jscodeshift, verbose } = options

packages/next-codemod/lib/utils.ts

@@ -121,4 +121,9 @@ export const TRANSFORMER_INQUIRER_CHOICES = [
     value: 'next-experimental-turbo-to-turbopack',
     version: '10.0.0',
   },
+  {
+    title: 'Migrate from `next lint` to explicit ESLint configuration',
+    value: 'next-lint-to-explicit-eslint',
+    version: '16.0.0',
+  },
 ]

packages/next-codemod/transforms/__testfixtures__/next-lint-to-explicit-eslint/basic.input.json

@@ -0,0 +1,22 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "next": "15.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19"
+  }
+}

packages/next-codemod/transforms/__testfixtures__/next-lint-to-explicit-eslint/basic.output.json

@@ -0,0 +1,25 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "next": "15.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "15.0.0",
+    "@eslint/eslintrc": "^3"
+  }
+}

packages/next-codemod/transforms/__testfixtures__/next-lint-to-explicit-eslint/existing-eslint.input.json

@@ -0,0 +1,20 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "next": "15.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.0.0",
+    "eslint-config-next": "15.0.0"
+  }
+}

packages/next-codemod/transforms/__testfixtures__/next-lint-to-explicit-eslint/existing-eslint.output.json

@@ -0,0 +1,21 @@
+{
+  "name": "my-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "next": "15.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^8.0.0",
+    "eslint-config-next": "15.0.0",
+    "@eslint/eslintrc": "^3"
+  }
+}

packages/next-codemod/transforms/__tests__/next-lint-to-explicit-eslint.test.js

@@ -0,0 +1,16 @@
+/* global jest */
+import { defineTest } from 'jscodeshift/dist/testUtils'
+
+jest.autoMockOff()
+
+const transform = 'next-lint-to-explicit-eslint'
+const fixtures = [
+  'basic',
+  'existing-eslint',
+]
+
+for (const fixture of fixtures) {
+  defineTest(__dirname, transform, {}, `${transform}/${fixture}`, {
+    parser: 'json',
+  })
+}