\n \n Daniel Bannert's open source work is supported by the community on GitHub Sponsors\n \n
\n
\n\n---\n\n## Install\n\n```sh\nnpm install @anolilab/eslint-config\n```\n\n```sh\nyarn add @anolilab/eslint-config\n```\n\n```sh\npnpm add @anolilab/eslint-config\n```\n\n## Purpose\n\nOur package serves as a valuable resource for JavaScript/Typescript-based projects, offering composable [ESLint](https://eslint.org/) configurations. It encompasses a range of features, including performance optimization and the flexibility to extend pre-defined base configurations. We aim to provide a strong, opinionated foundation for code quality and consistency, while still allowing for customization to suit specific project needs.\n\n- Tailored Configuration for Workspaces: With this package, each workspace within your monorepo gains the ability to have its own customized ESLint configuration. This ensures that individual projects can maintain their specific requirements while still adhering to the overall guidelines.\n- Configurability at Your Fingertips: Crafting your workspace’s ESLint configuration is a breeze, thanks to the seamless composition of pre-defined base configurations. This empowers you to tailor the settings to suit your project’s unique needs, without starting from scratch.\n\n- Enhanced Efficiency: We’ve optimized the package’s performance by intelligently enabling plugins based on file naming conventions and project dependencies. This streamlined approach ensures that your ESLint checks run efficiently, targeting the relevant files and maximizing productivity.\n\n> [!NOTE]\n> Since v16.0.0, this config is rewritten to the new [ESLint Flat config](https://eslint.org/docs/latest/use/configure/configuration-files-new).\n>\n> ESLint v9.5.0+ is now required.\n\n> [!WARNING]\n>\n> Please keep in mind that this is still **_a personal config_** with a lot of opinions. Changes might not always work for everyone and every use case.\n>\n> If you are using this config directly, I suggest you **review the changes every time you update**. Or if you want more control over the rules, always feel free to fork it. Thanks!\n\n## Highlights\n\n- Zero-config for many common setups, but highly configurable when needed.\n- Enforces readable and consistent code, because you read more code than you write.\n- Lints a wide range of files, including JavaScript, TypeScript, JSON, YAML, Markdown, and more.\n- No need to specify file paths to lint as it intelligently lints relevant files, respecting `.gitignore` and common ignore patterns.\n- Config overrides per files/globs.\n- First-class TypeScript support, automatically enabled if `typescript` is detected in your project.\n- Includes a comprehensive set of ESLint plugins, like [unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn), [import](https://github.com/import-js/eslint-plugin-import), [sonarjs](https://github.com/SonarSource/eslint-plugin-sonarjs), and [security](#security) plugins. (See more under [Plugins](#plugins)).\n- Automatically enables relevant rules based on the [engines](https://docs.npmjs.com/files/package.json/#engines) field in your `package.json`.\n- Easily configure stylistic preferences like indent and semicolon without deep diving into rule configurations.\n- Works alongside Prettier: Our configuration disables ESLint rules that would conflict with Prettier, allowing ESLint to focus on code quality and Prettier on formatting if you choose to use both. However, many stylistic rules are included and can be enforced by ESLint directly.\n\n## Usage\n\nOur default export is designed to be used within ESLint’s flat configuration system (e.g., `eslint.config.js`). It contains a comprehensive set of ESLint rules, suitable for modern ECMAScript (ES2021+ by default) and TypeScript projects.\n\nTo use it, import the `createConfig` function from `@anolilab/eslint-config` into your `eslint.config.js` (or `eslint.config.mjs`). This function allows you to generate the configuration, optionally with your own settings.\n\nCreate `eslint.config.mjs` in your project root:\n\n```js\n// eslint.config.mjs\nimport { createConfig } from \"@anolilab/eslint-config\";\n\nexport default createConfig();\n```\n\n\n\nCombined with legacy config:\n\n\nIf you still use configs from the legacy eslintrc format, you can use the [`@eslint/eslintrc`](https://www.npmjs.com/package/@eslint/eslintrc) package to convert them to the flat config.\n\n```js\n// eslint.config.mjs\nimport { createConfig } from \"@anolilab/eslint-config\";\nimport { FlatCompat } from \"@eslint/eslintrc\";\n\nconst compat = new FlatCompat();\n\nexport default createConfig(\n {\n ignores: [],\n },\n\n // Legacy config\n ...compat.config({\n extends: [\n \"eslint:recommended\",\n // Other extends...\n ],\n }),\n\n // Other flat configs...\n);\n```\n\n> Note that `.eslintignore` no longer works in Flat config.\n\n\n\nOr you can configure each integration individually, for example:\n\n```js\n// eslint.config.js\nimport { createConfig } from \"@anolilab/eslint-config\";\n\n/** @type {import(\"@anolilab/eslint-config\").PromiseFlatConfigComposer} */\nexport default createConfig({\n // Enable stylistic formatting rules\n // stylistic: true,\n\n // `.eslintignore` is no longer supported in Flat config, use `ignores` instead\n ignores: [\n \"**/fixtures\",\n // ...globs\n ],\n\n // Disable jsonc and yaml support\n jsonc: false,\n // Or customize the stylistic rules\n stylistic: {\n indent: 2, // 4, or 'tab'\n quotes: \"single\", // or 'double'\n },\n\n // TypeScript and Vue are autodetected, you can also explicitly enable them:\n typescript: true,\n vue: true,\n\n yaml: false,\n});\n```\n\n### Add script for package.json\n\nFor example:\n\n```json\n{\n \"scripts\": {\n \"lint\": \"eslint .\",\n \"lint:fix\": \"eslint . --cache --concurrency auto --fix\"\n }\n}\n```\n\nThe factory function also accepts any number of arbitrary custom config overrides:\n\n```js\n// eslint.config.js\nimport { createConfig } from \"@anolilab/eslint-config\";\n\nexport default createConfig(\n {\n // Configures for anolilab's config\n },\n\n // From the second arguments they are ESLint Flat Configs\n // you can have multiple configs\n {\n files: [\"**/*.ts\"],\n rules: {},\n },\n {\n rules: {},\n },\n);\n```\n\nWe also provided the `overrides` options in each integration to make it easier:\n\n```js\n// eslint.config.js\nimport { createConfig } from \"@anolilab/eslint-config\";\n\n/** @type {import(\"@anolilab/eslint-config\").PromiseFlatConfigComposer} */\nexport default createConfig({\n typescript: {\n overrides: {\n \"ts/consistent-type-definitions\": [\"error\", \"interface\"],\n },\n },\n yaml: {\n overrides: {\n // ...\n },\n },\n});\n```\n\n## IDE Support (auto fix on save)\n\n\n🟦 VS Code support\n\n \n\nInstall [VS Code ESLint extension](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)\n\nAdd the following settings to your `.vscode/settings.json`:\n\n```jsonc\n{\n // Disable the default formatter, use eslint instead\n \"prettier.enable\": false,\n \"editor.formatOnSave\": false,\n\n // Auto fix\n \"editor.codeActionsOnSave\": {\n \"source.fixAll.eslint\": \"explicit\",\n \"source.organizeImports\": \"never\"\n },\n\n // Silent the stylistic rules in your IDE, but still auto fix them\n \"eslint.rules.customizations\": [\n { \"rule\": \"style/*\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"format/*\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-indent\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-spacing\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-spaces\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-order\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-dangle\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*-newline\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*quotes\", \"severity\": \"off\", \"fixable\": true },\n { \"rule\": \"*semi\", \"severity\": \"off\", \"fixable\": true }\n ],\n\n // Enable eslint for all supported languages\n \"eslint.validate\": [\n \"javascript\",\n \"javascriptreact\",\n \"typescript\",\n \"typescriptreact\",\n \"vue\",\n \"html\",\n \"markdown\",\n \"json\",\n \"jsonc\",\n \"yaml\",\n \"toml\",\n \"xml\",\n \"gql\",\n \"graphql\",\n \"astro\",\n \"svelte\",\n \"css\",\n \"less\",\n \"scss\",\n \"pcss\",\n \"postcss\"\n ]\n}\n```\n\n\n\n\n🟩 Neovim Support\n\n \n\nUpdate your configuration to use the following:\n\n```lua\nlocal customizations = {\n { rule = 'style/*', severity = 'off', fixable = true },\n { rule = 'format/*', severity = 'off', fixable = true },\n { rule = '*-indent', severity = 'off', fixable = true },\n { rule = '*-spacing', severity = 'off', fixable = true },\n { rule = '*-spaces', severity = 'off', fixable = true },\n { rule = '*-order', severity = 'off', fixable = true },\n { rule = '*-dangle', severity = 'off', fixable = true },\n { rule = '*-newline', severity = 'off', fixable = true },\n { rule = '*quotes', severity = 'off', fixable = true },\n { rule = '*semi', severity = 'off', fixable = true },\n}\n\nlocal lspconfig = require('lspconfig')\n-- Enable eslint for all supported languages\nlspconfig.eslint.setup(\n {\n filetypes = {\n \"javascript\",\n \"javascriptreact\",\n \"javascript.jsx\",\n \"typescript\",\n \"typescriptreact\",\n \"typescript.tsx\",\n \"vue\",\n \"html\",\n \"markdown\",\n \"json\",\n \"jsonc\",\n \"yaml\",\n \"toml\",\n \"xml\",\n \"gql\",\n \"graphql\",\n \"astro\",\n \"svelte\",\n \"css\",\n \"less\",\n \"scss\",\n \"pcss\",\n \"postcss\"\n },\n settings = {\n -- Silent the stylistic rules in your IDE, but still auto fix them\n rulesCustomizations = customizations,\n },\n }\n)\n```\n\n### Neovim format on save\n\nThere’s few ways you can achieve format on save in neovim:\n\n- `nvim-lspconfig` has a `EslintFixAll` command predefined, you can create an autocmd to call this command after saving file.\n\n```lua\nlspconfig.eslint.setup({\n --- ...\n on_attach = function(client, bufnr)\n vim.api.nvim_create_autocmd(\"BufWritePre\", {\n buffer = bufnr,\n command = \"EslintFixAll\",\n })\n end,\n})\n```\n\n- Use [conform.nvim](https://github.com/stevearc/conform.nvim).\n- Use [none-ls](https://github.com/nvimtools/none-ls.nvim)\n- Use [nvim-lint](https://github.com/mfussenegger/nvim-lint)\n\n\n\n### Using `getFilesGlobs` for Common File Types\n\nYour `@anolilab/eslint-config` package also exports a handy utility function `getFilesGlobs` that provides pre-defined glob patterns for common file types. This can simplify targeting specific sets of files in your ESLint configuration objects.\n\nYou can import it alongside `createConfig`:\n\n```javascript\n// eslint.config.js\nimport { createConfig, getFilesGlobs } from \"@anolilab/eslint-config\";\n\nconst baseConfig = createConfig();\n\n// Get glob patterns for all JavaScript and TypeScript files\nconst jsTsFiles = getFilesGlobs(\"js_and_ts\");\n// Get glob patterns for Markdown files\nconst markdownFiles = getFilesGlobs(\"markdown\");\n// Get glob patterns for HTML related files\nconst htmlFiles = getFilesGlobs(\"html\");\n\nexport default [\n ...baseConfig,\n {\n files: jsTsFiles,\n // languageOptions, rules, etc., specific to JS and TS files\n rules: {\n // 'your-rule/for-js-ts': 'error',\n },\n },\n {\n files: markdownFiles,\n // languageOptions, rules, etc., specific to Markdown files\n // Often, you might use a specific processor or plugin for Markdown here\n // processor: markdownProcessor, // Fictional example\n // plugins: { markdownPlugin } // Fictional example\n },\n {\n files: htmlFiles,\n // languageOptions, rules, etc., specific to HTML files\n },\n // ... other configurations\n];\n```\n\n### Type Aware Rules\n\nYou can optionally enable the [type aware](https://typescript-eslint.io/linting/typed-linting/) rules by passing the options object to the `typescript` config:\n\n```js\n// eslint.config.js\nimport { createConfig } from \"@anolilab/eslint-config\";\n\n/** @type {import(\"@anolilab/eslint-config\").PromiseFlatConfigComposer} */\nexport default createConfig({\n typescript: {\n tsconfigPath: \"tsconfig.json\",\n },\n});\n```\n\n### Utilities\n\nThe `getFilesGlobs` function accepts one of the following `FileType` strings:\n\n- `\"all\"`: All JavaScript, TypeScript, and declaration files.\n- `\"astro_ts\"`: TypeScript files within Astro components.\n- `\"astro\"`: Astro component files (`.astro`).\n- `\"css\"`: CSS files.\n- `\"types\"`: TypeScript declaration files (`.d.ts`, `.d.cts`, `.d.mts`).\n- `\"e2e\"`: End-to-end test files.\n- `\"graphql\"`: GraphQL files (`.gql`, `.graphql`).\n- `\"html\"`: Various HTML-like template files (`.html`, `.hbs`, `.erb`, etc.).\n- `\"js_and_ts\"`: All JavaScript and TypeScript source files (excluding declarations).\n- `\"js\"`: JavaScript files (`.js`, `.mjs`, `.cjs`).\n- `\"jsx_and_tsx\"`: JSX and TSX files.\n- `\"less\"`: LESS files.\n- `\"markdown_in_markdown\"`: Markdown files embedded within other Markdown files.\n- `\"markdown_inline_js_jsx\"`: JS/JSX code blocks within Markdown.\n- `\"markdown\"`: Markdown files (`.md`, `.mkdn`, etc.).\n- `\"postcss\"`: PostCSS configuration files.\n- `\"scss\"`: SCSS files.\n- `\"storybook\"`: Storybook story files.\n- `\"svg\"`: SVG files.\n- `\"toml\"`: TOML files.\n- `\"ts\"`: All TypeScript files including declarations and TSX (`.ts`, `.tsx`, `.d.ts`, etc.).\n- `\"vitest\"`: Vitest test files.\n- `\"xml\"`: XML files.\n- `\"yaml\"`: YAML files (`.yaml`, `.yml`).\n\nUsing `getFilesGlobs` can make your configuration more readable and maintainable by abstracting away the specific glob patterns.\n\n## Plugins\n\nOur configuration integrates a wide array of ESLint plugins to cover various aspects of code quality, language support, security, and specific libraries/frameworks. Many of these are enabled automatically when relevant dependencies are detected in your project.\n\n### Core & Code Quality\n\nThese plugins form the backbone of our linting rules, focusing on best practices, consistency, and potential errors.\n\n- **[@eslint/js](https://www.npmjs.com/package/@eslint/js)**: Core ESLint rules.\n- **[eslint-plugin-unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn)**: Various awesome ESLint rules.\n- **[eslint-plugin-sonarjs](https://github.com/SonarSource/eslint-plugin-sonarjs)**: Rules to detect bugs and code smells.\n- **[eslint-plugin-promise](https://github.com/eslint-community/eslint-plugin-promise)**: Enforce best practices for JavaScript promises.\n- **[eslint-plugin-es-x](https://github.com/eslint-community/eslint-plugin-es-x)** (formerly `eslint-plugin-es`): Prevent ES6+ syntax from being used in ES5 environments.\n- **[eslint-plugin-antfu](https://github.com/antfu/eslint-config)**: Opinionated linting rules by Anthony Fu.\n- **[eslint-plugin-perfectionist](https://github.com/azat-io/eslint-plugin-perfectionist)**: Rules for sorting and ordering various data structures.\n- **[eslint-plugin-no-for-of-array](https://github.com/smelukov/eslint-plugin-no-for-of-array)**: Disallow `for...of` loops on arrays (promoting array methods).\n- **[eslint-plugin-unused-imports](https://github.com/sweepline/eslint-plugin-unused-imports)**: Find and remove unused ES6 imports.\n\n### Stylistic & Formatting\n\nThese plugins help maintain a consistent code style. while these are included, you can also use Prettier for formatting, and our config is designed to be compatible.\n\n- **[@stylistic/eslint-plugin](https://eslint.style/packages/default)** (and `@stylistic/eslint-plugin-ts`): ESLint Stylistic, for all stylistic rules.\n- **[eslint-plugin-simple-import-sort](https://github.com/lydell/eslint-plugin-simple-import-sort)**: import sorting.\n- **[eslint-plugin-format](https://github.com/antfu/eslint-plugin-format)**: Enables formatting of various file types using Prettier or other formatters via ESLint.\n\n### Language Support & Syntax\n\nPlugins for specific languages or syntaxes beyond standard JavaScript/TypeScript.\n\n- **[@typescript-eslint/eslint-plugin](https://typescript-eslint.io/)**: The tooling that enables ESLint to lint TypeScript code.\n- **[eslint-plugin-jsonc](https://github.com/ota-meshi/eslint-plugin-jsonc)**: ESLint plugin for JSON, JSONC, and JSON5 files.\n- **[eslint-plugin-yml](https://github.com/ota-meshi/eslint-plugin-yml)**: ESLint plugin for YAML files.\n- **[eslint-plugin-toml](https://github.com/ota-meshi/eslint-plugin-toml)**: ESLint plugin for TOML files.\n- **[eslint-plugin-html](https://github.com/BenoitZugmeyer/eslint-plugin-html)**: An ESLint plugin to extract and lint script tags from HTML files.\n- **[@html-eslint/eslint-plugin](https://html-eslint.org/)**: Alternative ESLint plugin for HTML files.\n- **[@eslint/markdown](https://www.npmjs.com/package/@eslint/markdown)**: Lint JavaScript code blocks in Markdown documents.\n- **[eslint-plugin-astro](https://github.com/ota-meshi/eslint-plugin-astro)**: ESLint plugin for Astro components.\n\n### Import & Module System\n\nManaging imports and module structure.\n\n- **[eslint-plugin-import-x](https://github.com/un-ts/eslint-plugin-import-x)** (formerly `eslint-plugin-import`): Linting of ES2015+ (ES6+) import/export syntax, and prevent issues with misspelling of file paths, and import names.\n - Uses `eslint-import-resolver-node` and `eslint-import-resolver-typescript`.\n- **[eslint-plugin-n](https://github.com/eslint-community/eslint-plugin-n)** (formerly `eslint-plugin-node`): Additional ESLint rules for Node.js.\n\n### Security\n\nPlugins focused on identifying potential security vulnerabilities.\n\n- **[eslint-plugin-security](https://github.com/eslint-community/eslint-plugin-security)**: ESLint rules for Node Security.\n- **[eslint-plugin-no-secrets](https://github.com/nickdeis/eslint-plugin-no-secrets)**: An ESLint plugin that detects potential secrets/credentials.\n- **[eslint-plugin-no-unsanitized](https://github.com/mozilla/eslint-plugin-no-unsanitized)**: ESLint plugin for security related rules regarding untrusted input.\n\n### Testing\n\nPlugins for various testing frameworks and practices.\n\n- **[eslint-plugin-no-only-tests](https://github.com/levibuzolic/eslint-plugin-no-only-tests)**: Disallow `.only` calls in test files.\n- **[eslint-plugin-testing-library](https://github.com/testing-library/eslint-plugin-testing-library)**: ESLint plugin for Testing Library.\n- **[eslint-plugin-playwright](https://github.com/mskelton/eslint-plugin-playwright)**: ESLint plugin for Playwright.\n\n### Frameworks & Libraries\n\nSupport for specific UI frameworks, libraries, and tools.\n\n- **[@eslint-react/eslint-plugin](https://github.com/AriPerkkio/eslint-react)**: A comprehensive ESLint plugin for React.\n- **[eslint-plugin-react-hooks](https://www.npmjs.com/package/eslint-plugin-react-hooks)**: ESLint rules for React Hooks.\n- **[eslint-plugin-react-refresh](https://www.npmjs.com/package/eslint-plugin-react-refresh)**: Enforces best practices for React Fast Refresh.\n- **[eslint-plugin-jsx-a11y](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y)**: Static AST checker for accessibility rules on JSX elements.\n- **[eslint-plugin-validate-jsx-nesting](https://github.com/TitTat/eslint-plugin-validate-jsx-nesting)**: Validate JSX element nesting.\n- **[eslint-plugin-tailwindcss](https://github.com/francoismassart/eslint-plugin-tailwindcss)**: ESLint plugin for Tailwind CSS.\n- **[eslint-plugin-storybook](https://github.com/storybookjs/eslint-plugin-storybook)**: Best practice rules for Storybook.\n- **[@tanstack/eslint-plugin-query](https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query)**: ESLint rules for TanStack Query.\n- **[@tanstack/eslint-plugin-router](https://tanstack.com/router/latest/docs/eslint/eslint-plugin-router)**: ESLint rules for TanStack Router.\n- **[@unocss/eslint-plugin](https://github.com/unocss/unocss/tree/main/packages/eslint-plugin)**: ESLint plugin for UnoCSS.\n- **[eslint-plugin-zod](https://github.com/IsaacScript/eslint-plugin-zod)**: ESLint rules for Zod schemas.\n- **[eslint-plugin-you-dont-need-lodash-underscore](https://github.com/you-dont-need/You-Dont-Need-Lodash-Underscore)**: Encourages use of native JavaScript methods over Lodash/Underscore.\n\n### Documentation & Comments\n\n- **[@eslint-community/eslint-plugin-eslint-comments](https://github.com/eslint-community/eslint-plugin-eslint-comments)** (formerly `eslint-plugin-eslint-comments`): Additional ESLint rules for ESLint directive comments (`/*eslint-...*/`).\n- **[eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc)**: JSDoc specific linting rules.\n- **[eslint-plugin-tsdoc](https://github.com/microsoft/tsdoc/tree/main/eslint-plugin)**: TSDoc specific linting rules.\n\n### Compatibility & Others\n\n- **[eslint-plugin-compat](https://github.com/amilajack/eslint-plugin-compat)**: Lint the browser compatibility of your code.\n- **[eslint-config-flat-gitignore](https://github.com/antfu/eslint-config-flat-gitignore)**: Utility to use .gitignore in flat config.\n- **[eslint-flat-config-utils](https://github.com/antfu/eslint-flat-config-utils)**: Utilities for working with ESLint flat config.\n- **[eslint-merge-processors](https://github.com/eslint/eslint-merge-processors)**: Utility to merge ESLint processors.\n- **[@eslint/compat](https://www.npmjs.com/package/@eslint/compat)**: Utilities for compatibility between ESLint flat config and eslintrc.\n\n---\n\n### List of Used Plugins (Condensed)\n\nThis list is a more condensed version and not be exhaustive if plugins are specific or utility-based. It aims to provide a quick overview of the primary active linting plugins.\n\n- `@eslint/js`\n- `@stylistic/eslint-plugin`\n- `@typescript-eslint/eslint-plugin`\n- `@eslint-community/eslint-plugin-eslint-comments`\n- `@eslint-react/eslint-plugin`\n- `@tanstack/eslint-plugin-query`\n- `@tanstack/eslint-plugin-router`\n- `@unocss/eslint-plugin`\n- `eslint-plugin-antfu`\n- `eslint-plugin-astro`\n- `eslint-plugin-compat`\n- `eslint-plugin-es-x`\n- `eslint-plugin-format`\n- `eslint-plugin-html` (or `@html-eslint/eslint-plugin`)\n- `eslint-plugin-import-x`\n- `eslint-plugin-jsdoc`\n- `eslint-plugin-jsonc`\n- `eslint-plugin-jsx-a11y`\n- `eslint-plugin-n`\n- `eslint-plugin-no-only-tests`\n- `eslint-plugin-no-secrets`\n- `eslint-plugin-no-unsanitized`\n- `eslint-plugin-perfectionist`\n- `eslint-plugin-playwright`\n- `eslint-plugin-promise`\n- `eslint-plugin-react-hooks`\n- `eslint-plugin-regexp` (often a dependency of other plugins like SonarJS)\n- `eslint-plugin-security`\n- `eslint-plugin-simple-import-sort`\n- `eslint-plugin-sonarjs`\n- `eslint-plugin-storybook`\n- `eslint-plugin-tailwindcss`\n- `eslint-plugin-testing-library`\n- `eslint-plugin-toml`\n- `eslint-plugin-tsdoc`\n- `eslint-plugin-unicorn`\n- `eslint-plugin-unused-imports`\n- `eslint-plugin-yml`\n- `eslint-plugin-zod`\n- `eslint-plugin-you-dont-need-lodash-underscore`\n\n## Our Stance on Formatting\n\nThis ESLint configuration includes stylistic rules that can format your JavaScript and TypeScript code, promoting consistency.\n\n- **ESLint as the Primary Tool:** For JS/TS files, we encourage using ESLint for both linting code quality and enforcing code style. The VSCode settings above are configured to use ESLint as the default formatter for these files.\n- **Working with Prettier:** If you use Prettier in your project, this config is designed to be compatible. It disables ESLint rules that would conflict with Prettier’s formatting decisions. You can let Prettier handle formatting for files ESLint doesn’t cover (like CSS, HTML, etc.), or even use Prettier for JS/TS formatting and then have ESLint apply further fixes. However, for a streamlined experience with JS/TS, letting ESLint handle all aspects (quality and style) is often simpler.\n\n## Lint Staged / Pre-commit Hooks\n\nTo ensure code is linted and fixed before committing, we recommend integrating with a pre-commit tool like `lint-staged` and `husky`. Our sister package, `@anolilab/lint-staged-config`, is designed to work seamlessly with this ESLint configuration.\n\nExample `lint-staged` configuration in your `package.json` (or relevant file):\n\n```json\n// package.json\n{\n \"lint-staged\": {\n \"*.{js,jsx,ts,tsx}\": \"eslint --fix\"\n // Add other linters for other file types if needed\n }\n}\n```\n\nEnsure `husky` is set up to run `lint-staged` on pre-commit.\n\n## Versioning Policy\n\nThis project aims to follow Semantic Versioning.\n\n- **Major versions:** May include breaking changes to ESLint configurations, Node.js version support, or significant plugin changes.\n- **Minor versions:** May introduce new non-breaking rules, enable new plugins by default (if non-breaking), or update existing rules with new options.\n- **Patch versions:** Typically include bug fixes or minor tweaks to rule configurations.\n\nChanges to rule strictness (e.g., changing a ’warn' to an ’error') occur in minor versions if they reflect evolving best practices. We recommend reviewing changes when updating.\n\n## Q & A\n\n### Why not standard\n\nThe standard specification believes that everyone should not waste time in personalized specifications, but the entire community should unify a specification. This statement makes sense, but it runs against the ESLint’s design philosophy.\nDon’t you remember how ESLint defeated JSHint and became the most popular JS code inspection tool? It’s because of the plugin and configuration that ESLint advocates, which meets the individual needs of different technology stacks of different teams.\n\nTherefore, `@anolilab/eslint-config` also inherits the philosophy of ESLint. It will not force you to use our config.\n\n## Related\n\n## Supported Node.js Versions\n\nLibraries in this ecosystem make the best effort to track [Node.js’ release schedule](https://github.com/nodejs/release#release-schedule).\n\nHere’s [a post on why we think this is important](https://medium.com/the-node-js-collection/maintainers-should-consider-following-node-js-release-schedule-ab08ed4de71a).\n\n## Contributing\n\nIf you would like to help take a look at the [list of issues](https://github.com/anolilab/javascript-style-guide/issues) and check our [Contributing](.github/CONTRIBUTING.md) guidelines.\n\n> **Note:** please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.\n\n## Credits\n\n- [Daniel Bannert](https://github.com/prisis)\n\n- [All Contributors](https://github.com/anolilab/javascript-style-guide/graphs/contributors)\n\n- Inspired by and thankful for the work in configurations like:\n - [eslint-config-airbnb](https://www.npmjs.com/package/eslint-config-airbnb)\n - [eslint-config-canonical](https://github.com/gajus/eslint-config-canonical)\n - [@antfu/eslint-config](https://github.com/antfu/eslint-config) (for its modern approach and clear documentation)\n\n## Made with ❤️ at Anolilab\n\nThis is an open source project and will always remain free to use. If you think it’s cool, please star it 🌟. [Anolilab](https://anolilab.com/open-source) is a Development and AI Studio. Contact at [hello@anolilab.com](mailto:hello@anolilab.com) if you need any help with these technologies or want to say hi!\n\n## License\n\nThe anolilab eslint-config is open-sourced software licensed under the [MIT][license-url]\n\n\n\n[license-badge]: https://img.shields.io/npm/l/@anolilab/eslint-config?style=for-the-badge\n[license]: https://github.com/anolilab/javascript-style-guide/blob/main/LICENSE\n[npm-downloads-badge]: https://img.shields.io/npm/dm/@anolilab/eslint-config?style=for-the-badge\n[npm-downloads]: https://www.npmjs.com/package/@anolilab/eslint-config\n[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge\n[prs-welcome]: https://github.com/anolilab/javascript-style-guide/blob/main/.github/CONTRIBUTING.md\n[chat-badge]: https://img.shields.io/discord/902465130518949899.svg?style=for-the-badge\n[chat]: https://discord.com/invite/4VuvwWGaaB\n[typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript\n[typescript-url]: https://www.typescriptlang.org/\n[license-url]: https://opensource.org/licenses/MIT\n","readmeFilename":""}
![\"eslint-config\"](\"__assets__/package-og.svg\")
\n\n