https://github.com/zemd/eslint-flat-config
🐩 ESLint Configs for Modern JavaScript Projects in 2026
https://github.com/zemd/eslint-flat-config
eslint eslint-config eslint-rules eslint-shareable-configs
Last synced: about 1 month ago
JSON representation
🐩 ESLint Configs for Modern JavaScript Projects in 2026
- Host: GitHub
- URL: https://github.com/zemd/eslint-flat-config
- Owner: zemd
- License: apache-2.0
- Created: 2023-10-22T21:40:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-12T07:06:24.000Z (2 months ago)
- Last Synced: 2026-04-12T09:30:45.588Z (2 months ago)
- Topics: eslint, eslint-config, eslint-rules, eslint-shareable-configs
- Language: TypeScript
- Homepage: https://zemd-eslint-config.pages.dev/
- Size: 2.21 MB
- Stars: 9
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# ESLint Configs for Modern JavaScript Projects
Welcome to the ultimate ESLint setup — no fluff, just what you need to write clean, bug-free code. Say goodbye to unnecessary stress and hello to a smooth dev experience! 🎉
## Why This ESLint Config?
- As simple as flat configs can be — without re-inventing the classic nested config,
- Keeps your codebase clean while reducing friction 🧘,
- Focuses on catching bugs, not dictating your coding style 🐛,
- Minimal but configurable — use only what you need 🔧,
- Bundled support for _TypeScript_, _React.js_, _Playwright_, _Storybook_, _Vitest_, and more,
- **DOES NOT** enforce import sorting or stylistic formatting (that's a job for Prettier 😉),
- Works with eslint v9+
## Usage
> [!NOTE]
> Starting from `@zemd/eslint-flat-config`@v3.2.0, the package was split into multiple packages. Pick what suits your project best! 🛠️
### Available Packages
| Package | Version | Description |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| [`@zemd/eslint-js`](./packages/js/README.md) | [](https://npmjs.com/package/@zemd/eslint-js) | JavaScript-only rules. |
| [`@zemd/eslint-ts`](./packages/ts/README.md) | [](https://npmjs.com/package/@zemd/eslint-ts) | TypeScript rules (includes JS rules from @zemd/eslint-js). |
| [`@zemd/eslint-react`](./packages/react/README.md) | [](https://npmjs.com/package/@zemd/eslint-react) | React rules (includes TS rules from `@zemd/eslint-ts` and JS rules from `@zemd/eslint-js`). |
| [`@zemd/eslint-rock-stack`](./packages/rock-stack/README.md) | [](https://npmjs.com/package/@zemd/eslint-rock-stack) | Rules for Fullstack projects that include React.js, GraphQL, Playwright, Tailwind(optional), Turbo, Vitest, and Storybook. |
| [`@zemd/eslint-next`](./packages/next/README.md) | [](https://npmjs.com/package/@zemd/eslint-next) | Rules for Next.js projects (inherits from `@zemd/eslint-rock-stack`). |
| [`@zemd/eslint-astro`](./packages/astro/README.md) | [](https://npmjs.com/package/@zemd/eslint-astro) | Rules for Astro projects (includes also `@zemd/eslint-react` rules by default, but configurable). |
## Installation
```sh
npm install --save-dev eslint @zemd/eslint-rock-stack
```
## Configuration
### Basic Setup
```typescript
// eslint.config.js
import { typescript, storybook } from "@zemd/eslint-rock-stack";
export default [
...typescript(),
...storybook({
filesMain: ["./packages/storybook/.storybook/main.js"],
filesStories: ["./packages/storybook/**/*.{stories,story}.{js,jsx,ts,tsx}"],
}),
];
```
### More Advanced Setup
Want to remove specific rules? Just filter them out! 🔥
```typescript
// eslint.config.js
import rock from "@zemd/eslint-rock-stack";
export default rock().filter((feature) => !feature.name.startsWith("zemd/graphql"));
```
Or cherry-pick only what you need:
```typescript
// eslint.config.js
import { javascript, typescript, vitest } from "@zemd/eslint-rock-stack";
export default [...javascript(), ...typescript(), ...vitest()];
```
## Add script for package.json
```bash
npm pkg set scripts.lint="eslint ."
npm pkg set scripts.lint:fix="eslint . --fix"
```
or manually:
```json
{
"scripts": {
"lint": "eslint .",
"lint:fix": "eslint . --fix"
}
}
```
## Debug your rules
Use [`@eslint/config-inspector`](https://github.com/eslint/config-inspector) to debug your ESLint setup.
```bash
npx @eslint/config-inspector@latest
# or
bunx @eslint/config-inspector@latest
```
## Vision
This monorepo is all about making your life easier — less tool stress, more confidence. Here’s the philosophy behind it:
- 💠 No tool should block you from using language features,
- 💠 Minimal warnings, just meaningful errors that help (not annoy) you.
- 💠 No formatting rules — Prettier handles that so you don’t have to debate semicolons,
- 💠 Simple configuration — just native JS arrays, no unnecessary abstractions,
- 💠 Batteries included 🔋: Enable only what you need (TypeScript, React, Next.js, Tailwind, Vitest, Playwright, Storybook, etc.).
- 💠 Rules guide you to write better code, not force a rigid style.
## Inspirations and alternatives
- [Sheriff](https://www.eslint-config-sheriff.dev/) -- Great, but includes some stylistic restrictions,
- [Antfu config](https://github.com/antfu/eslint-config) -- Another solid choice,
- [XO](https://github.com/spence-s/flat-xo) -- Flat version of `xo`, but still in beta.
## License
All packages in this monorepo are licensed under **Apache-2.0 license** 😇.
## 💙 💛 Donate
[](https://u24.gov.ua/)