eslint-config-axkit 1.2.1 → 1.3.0

package/README.md

@@ -83,14 +83,17 @@ export default [
 
 ## Options
 
-| Option          | Type     | Description                                                                |
-| --------------- | -------- | -------------------------------------------------------------------------- |
-| `gitignorePath` | `string` | Path to `.gitignore` file. Patterns will be added to ESLint's ignore list. |
+| Option          | Type      | Description                                                                                                                                                                                                                               |
+| --------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `gitignorePath` | `string`  | Path to `.gitignore` file. Patterns will be added to ESLint's ignore list.                                                                                                                                                                |
+| `nextjs`        | `boolean` | Enable Next.js rules (`eslint-config-next` core-web-vitals + typescript). Requires `eslint-config-next` to be installed.                                                                                                                  |
+| `storybook`     | `boolean` | Enable Storybook rules (`eslint-plugin-storybook` flat/recommended). Requires `eslint-plugin-storybook` to be installed.                                                                                                                  |
+| `tailwindcss`   | `string`  | Path to the Tailwind CSS entry point (e.g. `"src/app/globals.css"`). Enables `eslint-plugin-better-tailwindcss` recommended rules enforcing stylistic and correctness rules. Requires `eslint-plugin-better-tailwindcss` to be installed. |
 
 ## Requirements
 
 - Node.js >= 22.14.0
-- ESLint >= 9
+- ESLint >= 10
 
 ## License
 

package/dist/index.d.ts

@@ -16,6 +16,13 @@ export type Options = {
      * Requires `eslint-plugin-storybook` to be installed.
      */
     storybook?: boolean;
+    /**
+     * Path to the Tailwind CSS entry point (e.g. `"src/app/globals.css"`).
+     * Enables eslint-plugin-better-tailwindcss recommended rules and configures
+     * the plugin to resolve project-specific classes, variants, and plugins.
+     * Requires `eslint-plugin-better-tailwindcss` to be installed.
+     */
+    tailwindcss?: string;
 };
 /**
  * Creates a complete ESLint flat config for TypeScript projects.
@@ -30,5 +37,6 @@ export type Options = {
  * Optional:
  * - Next.js rules (core-web-vitals + typescript) via `nextjs: true`
  * - Storybook rules (flat/recommended) via `storybook: true`
+ * - Tailwind CSS rules (better-tailwindcss/recommended) via `tailwindcss: "path/to/entry.css"`
  */
 export declare function axkit(options?: Options): Promise<Linter.Config[]>;

package/dist/index.js

@@ -19,9 +19,10 @@ import { vitestConfig } from "./vitest-config.js";
  * Optional:
  * - Next.js rules (core-web-vitals + typescript) via `nextjs: true`
  * - Storybook rules (flat/recommended) via `storybook: true`
+ * - Tailwind CSS rules (better-tailwindcss/recommended) via `tailwindcss: "path/to/entry.css"`
  */
 export async function axkit(options = {}) {
-    const { gitignorePath, nextjs, storybook } = options;
+    const { gitignorePath, nextjs, storybook, tailwindcss } = options;
     const configs = [];
     // ── Gitignore ──────────────────────────────────────────────────────
     if (gitignorePath) {
@@ -58,6 +59,19 @@ export async function axkit(options = {}) {
         const storybookPlugin = (await importOptional("eslint-plugin-storybook"));
         configs.push(...storybookPlugin.configs["flat/recommended"]);
     }
+    // ── Tailwind CSS (before Prettier) ─────────────────────────────────
+    if (tailwindcss) {
+        const tailwindPlugin = (await importOptional("eslint-plugin-better-tailwindcss"));
+        const tailwindConfig = tailwindPlugin.configs.recommended;
+        configs.push(...(Array.isArray(tailwindConfig) ? tailwindConfig : [tailwindConfig]), {
+            name: "axkit/tailwindcss-entry-point",
+            settings: {
+                "better-tailwindcss": {
+                    entryPoint: tailwindcss,
+                },
+            },
+        });
+    }
     // ── Prettier compatibility (must be last) ──────────────────────────
     configs.push(eslintConfigPrettier);
     return configs;

package/package.json

@@ -2,7 +2,7 @@
   "name": "eslint-config-axkit",
   "author": "Łukasz Jerciński",
   "license": "MIT",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Reusable ESLint flat config for TypeScript + Node.js projects with strict type checking, Prettier, Unicorn, and Vitest",
   "repository": {
     "type": "git",
@@ -60,12 +60,16 @@
   "peerDependencies": {
     "eslint": ">=10",
     "eslint-config-next": ">=16",
+    "eslint-plugin-better-tailwindcss": ">=4",
     "eslint-plugin-storybook": ">=10"
   },
   "peerDependenciesMeta": {
     "eslint-config-next": {
       "optional": true
     },
+    "eslint-plugin-better-tailwindcss": {
+      "optional": true
+    },
     "eslint-plugin-storybook": {
       "optional": true
     }