# @fullstacksjs/eslint-config

> fullstacks eslint config

Latest version **15.4.0** (published 2026-10-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install @fullstacksjs/eslint-config
pnpm add @fullstacksjs/eslint-config
yarn add @fullstacksjs/eslint-config
bun add @fullstacksjs/eslint-config
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 15.4.0 |
| Published | 2026-10-09 |
| First published | 2020-10-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 22 |
| Unpacked size | 176.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 103 |
| Author | fullstacks |
| Maintainers | fullstacksjs |

## Links

- npm: https://www.npmjs.com/package/@fullstacksjs/eslint-config
- Repository: https://github.com/fullstacksjs/eslint-config
- Homepage: https://github.com/fullstacksjs/eslint-config#readme
- Issues: https://github.com/fullstacksjs/eslint-config/issues
- npm.io page: https://npm.io/package/@fullstacksjs/eslint-config

## Dependencies (22)

- [globals](https://npm.io/package/globals.md) 17.13.0
- [local-pkg](https://npm.io/package/local-pkg.md) 1.2.1
- [eslint-plugin-n](https://npm.io/package/eslint-plugin-n.md) 18.4.1
- [typescript-eslint](https://npm.io/package/typescript-eslint.md) 8.71.1
- [eslint-plugin-jest](https://npm.io/package/eslint-plugin-jest.md) 29.16.6
- [eslint-plugin-regexp](https://npm.io/package/eslint-plugin-regexp.md) 3.3.1
- [@vitest/eslint-plugin](https://npm.io/package/@vitest/eslint-plugin.md) 1.6.27
- [eslint-plugin-cypress](https://npm.io/package/eslint-plugin-cypress.md) 7.0.2
- [eslint-plugin-promise](https://npm.io/package/eslint-plugin-promise.md) 7.3.0
- [@eslint/config-helpers](https://npm.io/package/@eslint/config-helpers.md) 0.7.0
- [eslint-plugin-import-x](https://npm.io/package/eslint-plugin-import-x.md) 4.17.1
- [eslint-plugin-prettier](https://npm.io/package/eslint-plugin-prettier.md) 5.5.6
- [eslint-plugin-storybook](https://npm.io/package/eslint-plugin-storybook.md) 10.6.1
- [@next/eslint-plugin-next](https://npm.io/package/@next/eslint-plugin-next.md) 16.4.0
- [@stylistic/eslint-plugin](https://npm.io/package/@stylistic/eslint-plugin.md) 5.10.0
- [eslint-flat-config-utils](https://npm.io/package/eslint-flat-config-utils.md) 3.2.0
- [eslint-plugin-jsx-a11y-x](https://npm.io/package/eslint-plugin-jsx-a11y-x.md) 0.2.0
- [eslint-plugin-playwright](https://npm.io/package/eslint-plugin-playwright.md) 2.12.1
- [@eslint-react/eslint-plugin](https://npm.io/package/@eslint-react/eslint-plugin.md) 5.24.8
- [eslint-plugin-perfectionist](https://npm.io/package/eslint-plugin-perfectionist.md) 5.12.1
- [eslint-plugin-react-refresh](https://npm.io/package/eslint-plugin-react-refresh.md) 0.5.7
- [eslint-plugin-better-tailwindcss](https://npm.io/package/eslint-plugin-better-tailwindcss.md) 4.9.0

## Recent versions

- 15.4.0 (latest) — 2026-10-09
- 12.4.2-next.2 (next) — 2025-07-01
- 15.3.0 — 2026-09-25
- 15.2.0 — 2026-09-10
- 15.1.0 — 2026-09-05
- 15.0.1 — 2026-08-12
- 15.0.0 — 2026-08-12
- 14.8.1 — 2026-07-25
- 14.8.0 — 2026-07-21
- 14.7.0 — 2026-06-11
- 14.6.0 — 2026-06-04
- 14.5.0 — 2026-05-31
- 14.4.0 — 2026-05-21
- 14.3.0 — 2026-05-06
- 14.2.0 — 2026-04-06
- … 233 more at https://npm.io/package/@fullstacksjs/eslint-config/versions

## README

<div align="center">

![logo](https://raw.githubusercontent.com/fullstacksjs/eslint-config/master/assets/banner.png)

<br/>

![download status][download-badge] ![version][version-badge] ![MIT License][license-badge]

</div>

## Installation

```sh
npm install --save-dev @fullstacksjs/eslint-config eslint prettier
```

⚡️ That's it, you don't need to install any eslint-plugin! If you already have some plugins installed, please remove them.

## Usage

To use the configuration, all you need is to export the generated config by the `defineConfig` function. It automatically enables required
plugins with **Auto Module Detection**.

```js
import { defineConfig } from '@fullstacksjs/eslint-config';

export default defineConfig({
  typescript: {
    tsconfigRootDir: import.meta.dirname, // Recommended when using TypeScript
  },
});
```

## How Module Detection Works

Automatic module detection enables ESLint plugins based on the dependencies listed in your `package.json`. It scans your project to identify
which tools you're using, and then activates the corresponding ESLint plugins accordingly.

For example, if your `package.json` includes `vitest` as a dependency, the configuration will automatically enable `eslint-plugin-vitest`
for you. (You don't need to install the plugin itself)

### Modules API

You can fine-tune module detection by overriding it, the `defineConfig` function accepts options as its first argument to control enabled
modules.

```typescript
interface Options {
  base?: boolean | ‌ConfigWithOverrides; // controls base
  promise?: boolean | ‌ConfigWithOverrides; // controls promise
  stylistic?: boolean | ‌ConfigWithOverrides; // controls stylistic
  react?: boolean | ReactOptions; // controls react, react-hooks, jsx-a11y-x plugins
  typescript?: boolean | TypeScriptOptions; // https://typescript-eslint.io/packages/parser#configuration
  node?: boolean | ‌ConfigWithOverrides; // controls node plugin
  sort?: boolean | ‌ConfigWithOverrides; // controls perfectionist plugin
  strict?: boolean; // controls strict rules
  import?: boolean | ImportOptions; // controls import plugin
  esm?: boolean; // deprecated, has no effect; use import.extensions instead. Will be removed in the next major version
  test?: boolean | ‌ConfigWithOverrides; // controls test formatting plugin
  jest?: boolean | ‌ConfigWithOverrides; // controls jest plugin
  vitest?: boolean | ‌ConfigWithOverrides; // controls vitest plugin
  cypress?: boolean | ‌ConfigWithOverrides; // controls cypress plugin
  playwright?: boolean | ‌ConfigWithOverrides; // controls playwright plugin
  storybook?: boolean | ‌ConfigWithOverrides; // controls storybook plugin
  tailwind?: false | TailwindOptions; // controls tailwindcss plugin
  next?: boolean | ‌ConfigWithOverrides; // controls next plugin
  prettier?: boolean | ‌ConfigWithOverrides; // controls prettier plugin
  disableExpensiveRules?: boolean; // controls expensive rules
  gitignore?: false | string; // automatically ignore paths from .gitignore
  regex?: boolean | RegexOptions; // controls regexp plugin
}
```

## Config Overrides

You can customize any generated ESLint configuration per module.

```ts
defineConfig({
  stylistic: {
    overrides: {
      rules: {
        '@stylistic/semi': ['error', 'always'],
      },
    },
  },
});
```

## What if I want to add my one rules

You can pass any number of arbitrary custom config overrides to `defineConfig` function:

```js
import { defineConfig } from '@fullstacksjs/eslint-config';

export default defineConfig(
  {
    typescript: true,
    // You can pass extends here
    rules: {
      'no-console': 'error',
    },
  },
  // And any number of extra configurations
  {
    files: ['**/*.ts'],
    rules: {},
  },
  {
    rules: {},
  },
);
```

## What If I Want to Use a Plugin That Isn't Supported?

You can still use any ESLint plugin, even if it's not supported by automatic detection. Simply install the plugin manually and add it to the
`defineConfig`. There are no limitations.

```js
import { defineConfig } from '@fullstacksjs/eslint-config';
import pluginVue from 'eslint-plugin-vue';

export default defineConfig({/* Options */}, ...pluginVue.configs['flat/recommended']);
```

## Tailwind

To enable Tailwind CSS in your project, specify the path to your CSS file in the module configuration:

Tailwind 4:

```typescript
export default defineConfig({
  tailwind: { entryPoint: './src/global.css' },
});
```

Tailwind 3:

```typescript
export default defineConfig({
  tailwind: { tailwindConfig: './tailwind.config.js' },
});
```

## GitIgnore

By default, FullstacksJS checks for a `.gitignore` file in the current working directory. If the file exists, it will be used automatically.
Relative paths are resolved from the current working directory, so use an absolute path in monorepos or when your editor may start ESLint
from another folder.

```typescript
import path from 'node:path';

export default defineConfig({
  gitignore: path.join(import.meta.dirname, '.gitignore'), // use `false` to disable
});
```

## I'm Getting a Next.js Warning: Plugin Was Not Detected

This configuration includes built-in support for [Next.js](https://nextjs.org). The warning you're seeing from Next.js is misleading—it
simply checks whether the plugin is explicitly listed in your package.json.

You can safely ignore this warning. Alternatively, you can update your lint script from next lint to eslint to avoid it entirely.

## Speed Optimization!

Balancing the benefits of linting rules against their performance impact is crucial. Below is a table highlighting the most
resource-intensive linting rules encountered in a real-world React project:

| Rule                                   | Time (ms) | Relative |
| -------------------------------------- | --------- | -------- |
| prettier/prettier                      | 3299.631  | 19.2%    |
| @typescript-eslint/no-misused-promises | 2473.767  | 14.4%    |
| import/no-cycle                        | 1177.111  | 6.8%     |
| import/namespace                       | 1148.731  | 6.7%     |

As illustrated, certain rules significantly increase linting time, potentially hindering the developer experience by slowing down the
feedback loop. To mitigate this, you may consider disabling these resource-intensive rules in the development environment. However, they can
remain active in environments where performance is less critical, such as Continuous Integration (CI) systems or during pre-commit checks
(git hooks).

To conditionally disable expensive linting rules, you can modify your configuration as follows:

List of `expensiveRules` to be affected:

```sh
@typescript-eslint/no-floating-promises
@typescript-eslint/no-misused-promises
import/default # (disabled in TS env)
import/export # (disabled in TS env)
import/named # (disabled in TS env)
import/no-named-as-default-member # (disabled in TS env)
import/namespace
import/no-cycle
import/no-deprecated
```

```js
export default defineConfig({
  disableExpensiveRules: !process.env.CI || !process.env.HUSKY, // Or anywhere you want
  prettier: false, // So you should run the formatter explicitly.
});
```

## Migration Guide

[See Migration Guide](./MIGRATION.md)

## What's included?

- [@eslint-react/eslint-plugin](https://eslint-react.xyz)
- [@next/eslint-plugin-next](https://nextjs.org/docs/basic-features/eslint#eslint-plugin)
- [@stylistic/eslint-plugin](https://eslint.style/packages/default)
- [@vitest/eslint-plugin](https://github.com/vitest-dev/eslint-plugin-vitest)
- [eslint-plugin-cypress](https://github.com/cypress-io/eslint-plugin-cypress)
- [eslint-plugin-import-x](https://github.com/un-ts/eslint-plugin-import-x)
- [eslint-plugin-jest](https://github.com/jest-community/eslint-plugin-jest)
- [eslint-plugin-jest-formatting](https://github.com/dangreenisrael/eslint-plugin-jest-formatting)
- [eslint-plugin-jsx-a11y-x](https://github.com/es-tooling/eslint-plugin-jsx-a11y-x)
- [eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n)
- [eslint-plugin-perfectionist](https://perfectionist.dev)
- [eslint-plugin-playwright](https://github.com/playwright-community/eslint-plugin-playwright)
- [eslint-plugin-prettier](https://github.com/prettier/eslint-plugin-prettier)
- [eslint-plugin-promise](https://github.com/eslint-community/eslint-plugin-promise)
- [eslint-plugin-storybook](https://github.com/storybookjs/eslint-plugin-storybook#readme)
- [eslint-plugin-better-tailwindcss](https://github.com/schoero/eslint-plugin-better-tailwindcss)
- [typescript-eslint](https://typescript-eslint.io)
- [eslint-plugin-regexp](https://www.npmjs.com/package/eslint-plugin-regexp)
- [eslint-flat-config-utils](https://www.npmjs.com/package/eslint-flat-config-utils)
- [eslint-plugin-react-refresh](https://www.npmjs.com/package/eslint-plugin-react-refresh)

That's all. Feel free to use 💛

[download-badge]: https://img.shields.io/npm/dm/@fullstacksjs/eslint-config?color=6464E2&label=DOWNLOADS&style=flat-square
[version-badge]: https://img.shields.io/npm/v/@fullstacksjs/eslint-config?color=6464E2&label=VERSION&style=flat-square
[license-badge]: https://img.shields.io/npm/l/@fullstacksjs/eslint-config?color=6464E2&label=LICENSE&style=flat-square

---
_Source: https://npm.io/package/@fullstacksjs/eslint-config · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._