@bratislava/eslint-config-next 0.10.0 → 0.12.0

package/README.md

@@ -0,0 +1,114 @@
+# @bratislava/eslint-config-next
+
+ESLint configuration for Next.js frontend projects. Built for ESLint v9 flat config format.
+
+Part of a monorepo of shareable ESLint configurations — see the [full repo](https://github.com/bratislava/eslint-config) for base, NestJS, and React variants.
+
+## Installation
+
+```bash
+npm install --save-dev @bratislava/eslint-config-next eslint typescript eslint-plugin-tailwindcss
+```
+
+## Usage
+
+Create `eslint.config.mjs` in your project root:
+
+```javascript
+import nextConfig from "@bratislava/eslint-config-next";
+
+export default nextConfig;
+```
+
+Or use the factory function for customization:
+
+```javascript
+import { createNextConfig } from "@bratislava/eslint-config-next";
+
+export default createNextConfig({
+  ignores: ["services/graphql/**"],
+});
+```
+
+## Tailwind CSS
+
+`eslint-plugin-tailwindcss` is a peer dependency — you install the version that matches your project's Tailwind version.
+
+### Tailwind v3
+
+```bash
+npm install --save-dev eslint-plugin-tailwindcss
+```
+
+No additional configuration needed — the preconfigured rules work out of the box with v3.
+
+### Tailwind v4
+
+```bash
+npm install --save-dev eslint-plugin-tailwindcss@beta
+```
+
+The beta version might have issues — see the [v4 branch](https://github.com/francoismassart/eslint-plugin-tailwindcss/tree/alpha/v4) for more info.
+
+Tailwind v4 users must include the following settings in their `eslint.config.mjs`:
+
+```javascript
+// eslint.config.mjs
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { createNextConfig } from "@bratislava/eslint-config-next";
+
+export default [
+  ...createNextConfig(),
+  {
+    settings: {
+      tailwindcss: {
+        // The absolute path pointing to your main Tailwind CSS v4 config file.
+        // It must be a `.css` file (v4), not a `.js` file (v3)
+        // REQUIRED, default value will not help
+        cssConfigPath: dirname(fileURLToPath(import.meta.url)) + "/styles/tailwind.css",
+
+        // Optional, generally not needed in bratislava FE projects:
+
+        // Attributes/props that could contain Tailwind CSS classes...
+        // Optional, default values: ["class", "className", "ngClass", "@apply"]
+        // attributes: ["..."],
+
+        // Functions/tagFunctions that will be parsed by the plugin.
+        // Optional, default values: ["classnames", "clsx", "ctl", "cva", "tv", "tw"]
+        // functions: ["..."]
+      },
+    },
+  },
+];
+```
+
+Additionally, v4 requires an empty `tailwind.config.js` at the project root, otherwise the plugin throws "Cannot resolve default tailwindcss config path" warnings. See [this issue](https://github.com/francoismassart/eslint-plugin-tailwindcss/issues/431) for details.
+
+```javascript
+// tailwind.config.js
+export default {};
+```
+
+## What's Included
+
+Everything from `@bratislava/eslint-config` (base), plus:
+
+- **Next.js** plugin with recommended and Core Web Vitals rules
+- **React** plugin with recommended rules
+- **React Hooks** plugin
+- **JSX A11y** accessibility rules
+- **TanStack Query** plugin
+- **Tailwind CSS** class linting
+- **i18next** internationalization rules
+- Browser and Node.js globals
+
+## Peer Dependencies
+
+- `eslint` >= 9
+- `eslint-plugin-tailwindcss` >= 3.18.3 or >= 4.0.0-0 (beta)
+- `typescript` >= 5
+
+## License
+
+EUPL-1.2

package/index.js

@@ -147,6 +147,7 @@ export function createNextConfig(options = {}) {
         ...frontendRules,
         ...reactRules,
         ...nextRules,
+        "tailwindcss/migration-from-tailwind-2": "off",
         "sonarjs/different-types-comparison": "off", // TODO consider removing
       },
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bratislava/eslint-config-next",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "ESLint configuration for Next.js frontend projects",
   "keywords": [
     "eslint",
@@ -28,17 +28,17 @@
   ],
   "peerDependencies": {
     "eslint": ">= 9",
+    "eslint-plugin-tailwindcss": ">= 3.18.3 || >= 4.0.0-0",
     "typescript": ">= 5"
   },
   "dependencies": {
-    "@bratislava/eslint-config": "0.10.0",
+    "@bratislava/eslint-config": "0.12.0",
     "@next/eslint-plugin-next": "15.5.2",
     "@tanstack/eslint-plugin-query": "5.91.2",
     "eslint-plugin-i18next": "6.1.3",
     "eslint-plugin-jsx-a11y": "6.10.2",
     "eslint-plugin-react": "7.37.5",
     "eslint-plugin-react-hooks": "7.0.1",
-    "eslint-plugin-tailwindcss": "3.18.2",
     "globals": "16.5.0"
   },
   "engines": {