@drazenbebic/eslint-config-next 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Drazen Bebic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,126 @@
+# @drazenbebic/eslint-config-next
+
+> Opinionated, shareable [ESLint flat config](https://eslint.org/docs/latest/use/configure/configuration-files) for personal Next.js projects.
+
+It composes the official [`eslint-config-next`](https://www.npmjs.com/package/eslint-config-next) (Core Web Vitals + TypeScript) with Prettier, import sorting, unused-import removal, and [`perfectionist`](https://perfectionist.dev/) sorting — so a new Next.js app gets a consistent, batteries-included lint setup from a single dependency.
+
+> **Heads up:** this is a personal config tuned to my own preferences. You're welcome to use it, but it will change to suit my projects, not yours. Pin a version if that matters to you.
+
+## What's inside
+
+- **`eslint-config-next/core-web-vitals`** and **`eslint-config-next/typescript`** — the official Next.js rules.
+- **Prettier** via [`eslint-plugin-prettier`](https://github.com/prettier/eslint-plugin-prettier) (`prettier/prettier` runs as an ESLint rule, and conflicting stylistic rules are turned off by `eslint-config-prettier`).
+- **`simple-import-sort`** — deterministic import/export ordering grouped as: side-effects → React/Next/node builtins → third-party → `@/` alias → relative.
+- **`unused-imports`** — auto-removes unused imports and warns on unused vars.
+- **`perfectionist`** — alphabetical sorting of JSX props, named imports/exports, union/intersection types, arrays, and more.
+- A few hand-picked core rules: `no-console` (allowing `warn`/`error`), `curly: all`, and `padding-line-between-statements` (blank lines around `if`/`for`/`try`/`return`).
+- Default ignores: `.next/**`, `out/**`, `build/**`, `next-env.d.ts`.
+
+## Requirements
+
+- **Node.js** `>= 20`
+- **ESLint** `^9 || ^10` (flat config only — there is no `.eslintrc` support)
+- **Next.js** (`next`) `>= 15` — already in your app; required because this config extends `eslint-config-next`, whose parser loads from `next`
+- **Prettier** `^3`
+- **TypeScript** `>= 5` (optional, only if your project uses it)
+
+The ESLint plugins themselves ship as dependencies of this package, so you don't install them separately — only the peers above. In a real Next.js project `next` is already present, so you typically only add `eslint` and `prettier`.
+
+## Installation
+
+```bash
+pnpm add -D @drazenbebic/eslint-config-next eslint prettier
+# add typescript if your project uses it:
+pnpm add -D typescript
+```
+
+<details>
+<summary>npm / yarn</summary>
+
+```bash
+npm install -D @drazenbebic/eslint-config-next eslint prettier typescript
+# or
+yarn add -D @drazenbebic/eslint-config-next eslint prettier typescript
+```
+
+</details>
+
+## Usage
+
+Create an `eslint.config.mjs` (flat config) at the root of your project:
+
+```js
+import config from '@drazenbebic/eslint-config-next';
+
+export default config;
+```
+
+That's it. The default export is a flat-config array, so you can spread it and add your own overrides on top.
+
+### Adding project-specific overrides
+
+Because the config is a plain array, anything you add **after** the spread wins:
+
+```js
+import { globalIgnores } from 'eslint/config';
+
+import config from '@drazenbebic/eslint-config-next';
+
+const eslintConfig = [
+  ...config,
+
+  // Ignore generated files (e.g. Sanity TypeGen output).
+  globalIgnores(['sanity.types.ts']),
+
+  // Tweak or disable rules for your project.
+  {
+    rules: {
+      'no-console': 'off',
+    },
+  },
+];
+
+export default eslintConfig;
+```
+
+> **Note:** This config no longer ignores `sanity.types.ts` by default — add the `globalIgnores` line above in projects that use Sanity TypeGen.
+
+### Prettier
+
+`prettier/prettier` runs inside ESLint, so formatting issues show up as lint errors and are fixable with `eslint --fix`. Add your own `.prettierrc` to control formatting (this config does not impose a Prettier style on your project). A typical `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "next lint",
+    "lint:fix": "eslint . --fix"
+  }
+}
+```
+
+### The `@/` import group
+
+The import-sort rules put imports matching `^@/` in their own group, which assumes you use the `@/*` path alias (the Next.js default). If you use a different alias, override `simple-import-sort/imports` in your project config.
+
+## Releasing (maintainer notes)
+
+This package uses [release-please](https://github.com/googleapis/release-please) with **Conventional Commits**. Versions, the changelog, and the GitHub release are derived from commit messages on `main`:
+
+- `feat: …` → minor bump
+- `fix: …` / `perf: …` → patch bump
+- `feat!: …` or a `BREAKING CHANGE:` footer → major bump (minor while pre-1.0)
+
+When release-please's "Version Packages" PR is merged, the `release-please` workflow publishes to npm with [provenance](https://docs.npmjs.com/generating-provenance-statements) using [npm trusted publishing](https://docs.npmjs.com/trusted-publishers) (OIDC) — there is no long-lived `NPM_TOKEN` secret to manage.
+
+**One-time bootstrap** (because npm can only attach a trusted publisher to a package that already exists):
+
+1. Publish once manually to claim the name and create the package:
+   ```bash
+   npm publish --access public
+   ```
+2. On npmjs.com → the package's **Settings → Trusted Publisher**, add this repo's GitHub Actions workflow (`.github/workflows/release-please.yml`).
+3. From then on, merging the release-please PR publishes hands-free via OIDC.
+
+## License
+
+[MIT](./LICENSE)

package/index.js

@@ -0,0 +1,87 @@
+import { defineConfig, globalIgnores } from 'eslint/config';
+import nextVitals from 'eslint-config-next/core-web-vitals';
+import nextTs from 'eslint-config-next/typescript';
+import pluginPerfectionist from 'eslint-plugin-perfectionist';
+import prettierRecommended from 'eslint-plugin-prettier/recommended';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import pluginUnusedImports from 'eslint-plugin-unused-imports';
+
+const PERFECTIONIST_DEFAULT_ARGS = {
+  type: 'alphabetical',
+  order: 'asc',
+};
+
+const PERFECTIONIST_DEFAULT_CONFIG = ['error', PERFECTIONIST_DEFAULT_ARGS];
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  prettierRecommended,
+  {
+    settings: {
+      react: {
+        version: '19',
+      },
+    },
+    plugins: {
+      perfectionist: pluginPerfectionist,
+      'unused-imports': pluginUnusedImports,
+      'simple-import-sort': simpleImportSort,
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      'unused-imports/no-unused-imports': 'warn',
+      'unused-imports/no-unused-vars': 'warn',
+      'no-console': ['warn', { allow: ['warn', 'error'] }],
+      curly: ['error', 'all'],
+      'padding-line-between-statements': [
+        'error',
+        { blankLine: 'always', prev: '*', next: 'if' },
+        { blankLine: 'always', prev: 'if', next: '*' },
+        { blankLine: 'always', prev: '*', next: 'for' },
+        { blankLine: 'always', prev: 'for', next: '*' },
+        { blankLine: 'always', prev: '*', next: 'try' },
+        { blankLine: 'always', prev: 'try', next: '*' },
+        { blankLine: 'always', prev: '*', next: 'return' },
+      ],
+      'simple-import-sort/exports': 'error',
+      'simple-import-sort/imports': [
+        'error',
+        {
+          groups: [
+            // 1. Side effect imports (e.g. import 'style.css')
+            ['^\\u0000'],
+            // 2. React, Next.js, and other node built-ins
+            ['^react', '^next', '^node:'],
+            // 3. Third-party packages (starting with a letter or @)
+            ['^@?\\w'],
+            // 4. Internal imports (using your @/ alias)
+            ['^@/'],
+            // 5. Relative imports (starting with .)
+            ['^\\.'],
+          ],
+        },
+      ],
+      'perfectionist/sort-jsx-props': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-exports': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-named-exports': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-named-imports': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-intersection-types': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-array-includes': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-union-types': PERFECTIONIST_DEFAULT_CONFIG,
+      'perfectionist/sort-arrays': [
+        'error',
+        {
+          ...PERFECTIONIST_DEFAULT_ARGS,
+          useConfigurationIf: {
+            matchesAstSelector: 'TSAsExpression > ArrayExpression',
+          },
+        },
+      ],
+    },
+  },
+  // Default ignores carried over from eslint-config-next.
+  globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
+]);
+
+export default eslintConfig;

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@drazenbebic/eslint-config-next",
+  "version": "1.0.0",
+  "description": "Opinionated, shareable ESLint flat config for personal Next.js projects (Next + TypeScript + Prettier + import sorting + perfectionist).",
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "eslint-config",
+    "eslintconfig-next",
+    "next",
+    "nextjs",
+    "react",
+    "typescript",
+    "prettier",
+    "perfectionist",
+    "flat-config"
+  ],
+  "homepage": "https://github.com/drazenbebic/eslint-config-next#readme",
+  "bugs": {
+    "url": "https://github.com/drazenbebic/eslint-config-next/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drazenbebic/eslint-config-next.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Drazen Bebic",
+    "email": "drazen.bebic@outlook.com",
+    "url": "https://www.bebic.dev"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "main": "./index.js",
+  "sideEffects": false,
+  "files": [
+    "index.js"
+  ],
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "node --test"
+  },
+  "dependencies": {
+    "eslint-config-next": "^16.2.9",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-perfectionist": "^5.9.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
+    "eslint-plugin-unused-imports": "^4.4.1"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0",
+    "next": ">=15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "eslint": "^10.6.0",
+    "next": "^16.2.9",
+    "prettier": "^3.9.0",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@11.5.2"
+}