Chapter 13: Linter setup steps are outdated; cause circular reference issues

[turkycat]

Issue:
Running next lint as suggested by in chapter 13 produces circular dependency issues caused by outdated configurations installed by next lint.

This version of the tool produces an .eslintrc.json file which is out of date with eslint 9^

{
  "extends": [
    "next/core-web-vitals",
    "next/typescript"
  ]
}

running pnpm lint after setting it up results in:

$ pnpm lint

> @ lint /home/turkycat/scratch/nextjs/learn/nextjs-dashboard
> next lint

Converting circular structure to JSON
    --> starting at object with constructor 'Object'
    |     property 'configs' -> object with constructor 'Object'
    |     property 'flat' -> object with constructor 'Object'
    |     ...
    |     property 'plugins' -> object with constructor 'Object'
    --- property 'react' closes the circle
Referenced from: /<path-to>/nextjs/learn/nextjs-dashboard/.eslintrc.json

Resolved by:
following setup in this path https://nextjs.org/docs/app/api-reference/config/eslint

[OssamaLouati]

I can reproduce a related breakage from the same Chapter 13 flow, but with a different runtime error.

Environment:

• Next.js: 16.0.10
• eslint-config-next: 16.1.6
• ESLint: 10.0.3 (installed via latest)
• Node: 23.11.0
• pnpm: 10.28.2

When using eslint.config.mjs + eslint-config-next/core-web-vitals and running pnpm lint (eslint .), ESLint crashes with:

• Error while loading rule 'react/display-name': contextOrFilename.getFilename is not a function
• then TypeError: scopeManager.addGlobals is not a function

Workaround: pin ESLint to v9 (pnpm add -D eslint@^9.39.4), then lint runs.

So Chapter 13 appears outdated in two ways:

1. legacy .eslintrc path can cause circular reference issues (Chapter 13: Linter setup steps are outdated; cause circular reference issues #1137),
2. “latest” install can pull ESLint 10, which is incompatible with current eslint-config-next stack in this tutorial.