Skip to content

Upgrade web lint to ESLint 10 after the Next plugin stack supports it #93

Description

@yashranaway

Discovered while implementing #81 on 2026-08-10.

Next 16.3 provides native flat config, but its bundled lint plugin stack is not yet compatible with ESLint 10:

  • eslint-plugin-react@7.37.5 declares support through ESLint 9.7 and fails under ESLint 10 with contextOrFilename.getFilename is not a function.
  • eslint-plugin-import@2.32.0 declares support through ESLint 9.
  • eslint-plugin-jsx-a11y@6.10.2 declares support through ESLint 9.

The #81 migration therefore keeps ESLint 9 while upgrading Next and eslint-config-next to 16.3 and moving off FlatCompat. Dependabot ignores the ESLint semver-major update temporarily so it does not recreate a known-failing PR each week.

Done when

  • The plugins resolved by the current eslint-config-next support ESLint 10 without peer warnings or runtime failures.
  • Remove the Dependabot major-version ignore.
  • Upgrade ESLint to 10.
  • pnpm --filter @headless/web lint and pnpm --filter @headless/web build pass.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:webapps/web marketing and docs sitepriority:lowNice to havetype:choreMaintenance and cleanup

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions