eslint-config-un
Advanced tools
A universal-ish ESLint config aiming to be reasonably strict and easily configurable.
Grown out of the personal collection of rules, an ESLint config aspiring to cover as many rules as possible, be reasonably strict and easily configurable.
Vanilla JS rules,
typescript-eslint,
🦄unicorn,
⭐regexp,
node,
vue,
angular
react and 4 sister plugins,
solid,
tailwind,
css,
yaml
and many more;
eslintConfig() from eslint.config.ts is enough to get started;.gitignore: those files are not linted by default.Minimum supported versions:
npm i -D eslint-config-un eslint@latest
pnpm i -D eslint-config-un eslint@latest
yarn add -D eslint-config-un eslint@latest
Almost all the used plugins are direct dependencies of this package, you don't need to install them separately. We aim to update the dependencies within 1 month after their release.
Certain plugins are optional peer dependencies, which means that you need to install them manually if they are end up being used.
The reason for making these plugins not coming with this package is because they have heavy non-optional peer dependencies, such as graphql, storybook and tailwindcss. Not only that they're heavy, but having those peer dependencies installed would make this package think that the corresponding config is used.
| Default plugin prefix | Package name | Reason |
|---|---|---|
graphql | @graphql-eslint/eslint-plugin | Heavy dependency graphql |
betterTailwindcss | eslint-plugin-better-tailwindcss | Heavy dependency tailwindcss |
storybook | eslint-plugin-storybook | Heavy dependency storybook |
tailwindcss | eslint-plugin-tailwindcss | Heavy dependency tailwindcss |
turbo | eslint-plugin-turbo | Heavy dependency turbo |
eslintPlugin | eslint-plugin-eslint-plugin | Very specific plugin |
In your eslint.config.ts:
import {eslintConfig} from 'eslint-config-un';
export default eslintConfig({
// ... optional configuration ...
});
[!NOTE] We highly recommend using TypeScript config file, which is supported since ESLint v9.18.0, or
@ts-checkdirective at the start of the file otherwise.
eslint-config-un has a concept of Configs and Sub-configs. They are similar to ESLint flat config objects, but not the quite the same.
You can enable any Config by setting it to true or an object with the Config's options. Passing false disables the Config.
The Config has the following interface (exact types are simplified for docs):
type UnConfig =
| boolean
| {
files?: string[];
ignores?: string[];
[RuleName in ('overrides' | 'overridesAny')]?: {
[RuleName in string]:
| Severity
| [Severity, RuleOptions[RuleName]]
| ((
// These are severity and options *maybe* set by eslint-config-un
ourSeverity: Severity,
ourOptions?: RuleOptions[RuleName],
) => Severity | [Severity, RuleOptions[RuleName]]);
};
forceSeverity?: '2' | 'error' | '1' | 'warn';
[`config${string}`]: UnConfig; // These are Sub-configs
[customOptions: string]: unknown; // Custom config options, individual for each config
};
type Severity = 0 | 1 | 2 | 'off' | 'warn' | 'error';
configXXX naming convention.loadPluginsOnDemand option is set to false.files is an array of file globs to which this Config will be applied. If you specify an empty array [], the Config will be disabled, but not its Sub-configs.ignores is exactly the same as ESLint's ignores.overrides/overridesAny is similar to ESLint's rules, but with a very important advantage: you can provide a function that will be called with the rule severity and options set by eslint-config-un, which allows you to granularly override the options or change the severity of each rule.overrides and overridesAny is that overridesAny will allow any rule to be overridden (from TypeScript's stand point; technically you can pass any rule to overrides too), while overrides will only allow those rules which are tied to the config.overridesAny will be applied after overrides.forceSeverity allows to bulk override the severity of all the rules not overridden via overrides or overridesAny.Sub-config is a Config located within Config's options. If the parent config is disabled, all its Sub-configs are disabled too. In the following table, Sub-configs have / in their names.
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
js | ✅ | Vanilla ESLint rules | - |
ts | ✅ | typescript-eslint (ts) | Only rules not requiring type information. |
ts/typeAware | ✅ | ^ | Only rules requiring type information. |
ts/noTypeAssertion | ✅ | eslint-plugin-no-type-assertion (no-type-assertion) | - |
ts/sortTsconfigKeys | ❌ | - | Sort type-level and compilerOptions keys in tsconfig files. |
🦄 unicorn | ✅ | eslint-plugin-unicorn (unicorn) | - |
⭐ regexp | ✅ | eslint-plugin-regexp (regexp) | - |
promise | ✅ | eslint-plugin-promise (promise) | - |
import | ✅ | eslint-plugin-import-x (import) | - |
sonarjs | ✅ | eslint-plugin-sonarjs (sonarjs) | - |
eslintComments | ✅ | @eslint-community/eslint-plugin-eslint-comments (@eslint-community/eslint-comments) | Since v0.1.3 |
jsdoc | ✅ | eslint-plugin-jsdoc (jsdoc) | Since v0.3.1 |
jsdoc/typescript | ✅ (ts config is enabled) | - | Config for disabling or disabling certain rules for TypeScript files |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
vue | ✅ (vue is installed) | eslint-plugin-vue (vue) | - |
vue/a11y | ✅ | eslint-plugin-vuejs-accessibility (vuejs-accessibility) | - |
 vue/pinia | ✅ | eslint-plugin-pinia (pinia) | - |
angular | ✅ (@angular/core is installed) | @angular-eslint/eslint-plugin (@angular-eslint) | Since v0.78.0 |
angular/template | ✅ | @angular-eslint/eslint-plugin/template (@angular-eslint/template) | - |
react | ✅ (react is installed) | eslint-plugin-react (react) | Since v0.8.0 |
react/reactX | ✅ | @eslint-react/eslint-plugin (@eslint-react) | - |
react/hooks | ✅ | eslint-plugin-react-hooks (react-hooks)@eslint-react/eslint-plugin ( @eslint-react) | Includes rules with @eslint-react/hooks-extra prefix from @eslint-react/eslint-plugin |
react/dom | ✅ (react-dom is installed) | @eslint-react/eslint-plugin (@eslint-react)eslint-plugin-react | Includes rules with @eslint-react/dom prefix from @eslint-react/eslint-plugin and DOM related rules from eslint-plugin-react |
react/refresh | ✅ | eslint-plugin-react-refresh (react-refresh) | - |
react/compiler | ✅ (if React version is at least 19) | eslint-plugin-react-compiler (react-compiler) | - |
react/allowDefaultExportsInJsxFiles | ✅ | - | Config that allows default exports in all JSX files |
 nextJs | ✅ (next is installed) | @next/eslint-plugin-next (@next/next) | Since v0.9.0 |
solid | ✅ (solid-js is installed) | eslint-plugin-solid (solid) | Since v0.10.0 |
 qwik | ✅ (@builder.io/qwik or @qwik.dev/core is installed) | eslint-plugin-qwik (qwik) | Since v0.6.0 |
 astro | ✅ (astro is installed) | eslint-plugin-astro (astro) | Since v0.9.0 Without A11Y rules |
astro/jsxA11y | ✅ | ^ | Only A11Y rules from eslint-plugin-astro |
 svelte | ✅ (svelte is installed) | eslint-plugin-svelte (svelte) | Since v0.10.0 |
 ember | ✅ (ember-source is installed) | eslint-plugin-ember (ember) | Since v1.0.0 |
betterTailwind | ✅ (tailwindcss is installed) | eslint-plugin-better-tailwindcss (better-tailwindcss) | Since v1.0.0 Supports v4 and v3 |
tailwind | ❌ | eslint-plugin-tailwindcss (tailwindcss) | Only supports v3 |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
node | ✅ | eslint-plugin-n (node) | - |
 packageJson | ❌ | eslint-plugin-package-json (package-json) | Since v0.1.5 |
nodeDependencies | ❌ | eslint-plugin-node-dependencies (node-dependencies) | Since v0.10.0 |
depend | ❌ | eslint-plugin-depend (depend) | Since v1.0.0 |
 pnpm | ✅ (pnpm is detected as a package manager) | eslint-plugin-pnpm (pnpm) | Since v0.8.0 Does nothing, split into sub-configs |
pnpm/packageJson | ✅ | ^ | Plugin rules related to package.json files |
pnpm/pnpmWorkspace | ✅ | ^ | Plugin rules related to pnpm-workspace.yaml file |
 cloudfrontFunctions | ❌ | - | Since v0.10.0 For linting Amazon CloudFront Functions written for JavaScript Runtime v2 |
cloudfrontFunctions/V1 | ❌ | - | Same, but for JavaScript Runtime v1 functions |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
 markdown | ✅ | @eslint/markdown (markdown) | Since v0.7.0 Configured to also lint fenced code blocks inside .md files |
markdown/formatFencedCodeBlocks | ✅ (prettier is installed) | eslint-plugin-prettier (prettier) | Since v1.0.0 Format fenced code blocks inside Markdown files using Prettier |
 mdx | ✅ | eslint-plugin-mdx (mdx) | Since v1.0.0 Configured to also lint fenced code blocks inside .mdx files |
css | ✅ (unless stylelint is installed) | @eslint/css (css) | Since v0.7.0 |
cssInJs | ✅ | eslint-plugin-css (css-in-js) | Since v0.2.0 Lints inlined CSS |
jsxA11y | ✅ | eslint-plugin-jsx-a11y (jsx-a11y) | Since v0.8.0 |
yaml | ❌ | eslint-plugin-yaml (yaml) | Since v0.1.0 |
 jsonc | ❌ | eslint-plugin-jsonc (jsonc) | Since v0.1.4 Supports JSON, JSON5, JSONC |
jsonc/json | ❌ | ^ | Config exclusively for .json files, does nothing by default |
jsonc/jsonc | ❌ | ^ | Config exclusively for .jsonc files, does nothing by default |
jsonc/json5 | ❌ | ^ | Config exclusively for .json5 files, does nothing by default |
jsonSchemaValidator | ❌ | eslint-plugin-json-schema-validator (json-schema-validator) | Since v0.6.0 |
 toml | ❌ | eslint-plugin-toml (toml) | Since v0.1.3 |
 html | ✅ | @html-eslint/eslint-plugin (@html-eslint) | Since v0.10.0 |
 graphql | ✅ (graphql is installed) | @graphql-eslint/eslint-plugin (graphql) | Since v1.0.0 |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
security | ❌ | eslint-plugin-security (security) | - |
unusedImports | ❌ | eslint-plugin-unused-imports (unused-imports) | Since v0.7.0 |
unusedImports/noUnusedVars | ❌ | ^ | Disables no-unused-vars, ts/no-unused-vars and sonarjs/no-unused-vars rules in favor of unused-imports/no-unused-vars |
prefer-arrow-functions | ❌ | eslint-plugin-prefer-arrow-functions (prefer-arrow-functions) | Since v0.1.0 |
perfectionist | ❌ | eslint-plugin-perfectionist (perfectionist) | Since v0.4.0 Supports sub-configs for each rule from the plugin since v1.0.0 |
de-morgan | ❌ | eslint-plugin-de-morgan (de-morgan) | Since v0.5.0 |
es | ❌ | eslint-plugin-es-x (es-x) | Since v0.10.0 |
jsInline | ✅ | eslint-plugin-html (html) | Since v0.10.0 For linting inlined JS in HTML files |
math | ✅ | eslint-plugin-math (math) | Since v1.0.0 |
erasableSyntaxOnly | ❌ | eslint-plugin-erasable-syntax-only (erasable-syntax-only) | Since v1.0.0 |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
jest | ✅ (jest is installed) | eslint-plugin-jest (jest) | Since v0.3.0 |
jest/extended | ✅ (jest-extended is installed) | eslint-plugin-jest-extended (jest-extended) | - |
jest/typescript | ✅ (ts config is enabled) | eslint-plugin-jest (jest) | Only TypeScript-specific rules from eslint-plugin-jest |
vitest | ✅ (vitest is installed) | @vitest/eslint-plugin (vitest) | Since v0.3.0 |
ava | ✅ (ava is installed) | eslint-plugin-ava (ava) | Since v1.0.0 |
 testingLibrary | ✅ (@testing-library/dom is installed) | eslint-plugin-testing-library (testing-library) | Since v1.0.0 |
tanstackQuery | ✅ (@tanstack/query-core is installed) | @tanstack/eslint-plugin-query (@tanstack/query) | Since v1.0.0 |
 storybook | ✅ (storybook is installed) | eslint-plugin-storybook (storybook) | Since v1.0.0 |
 cypress | ✅ (cypress is installed) | eslint-plugin-cypress (cypress) | Since v1.0.0 |
 turbo | ✅ (turbo is installed) | eslint-plugin-turbo (turbo) | Since v1.0.0 |
| Un config name | Enabled by default? (optional condition) | Primary plugin(s) (default-prefix) | Description/Notes |
|---|---|---|---|
casePolice | ❌ | eslint-plugin-case-police (case-police) | Since v0.9.0 |
noStylisticRules | ❌ | - | Since v1.0.0 Config to disable most of the stylistic rules. Can be useful when integrating eslint-config-un into an existing project. |
noUnsanitized | ✅ | eslint-plugin-no-unsanitized (no-unsanitized) | Since v1.0.0 |
 cspell | ❌ | @cspell/eslint-plugin (@cspell) | Since v1.0.0 |
 eslintPlugin | ❌ | eslint-plugin-eslint-plugin (eslint-plugin) | Since v1.0.0 For linting ESLint plugins |
fileProgress | ❌ | eslint-plugin-file-progress (file-progress) | Since v1.0.0 An ESlint plugin to print file progress |
configs and extraConfigs option)Example of configuration:
import {eslintConfig} from 'eslint-config-un';
export default eslintConfig({
configs: {
// This is a Config
node: {
// By default `node` rules are applied to all files, so let's narrow the file list down
files: ['backend/**'],
},
vue: {
// For some reason we're not ready to lint *.vue files
files: [],
// This is a Sub-config
configPinia: {
ignores: ['./path/to/pinia/store/with-many-error.ts'],
},
},
// This config is disabled too, and if we provide an object with configuration, it will be enabled too
perfectionist: {
files: ['src/big-list-of-something.ts'],
overrides: {
'perfectionist/sort-objects': 2,
},
},
// This plugin is enabled by default, but we don't use JSDoc so don't need it
jsdoc: false,
// This plugin is conversely disabled by default, but we want to use it
security: true,
},
});
You can provide your own configs by using extraConfigs option. The provided configs will be placed after all the eslint-config-un's configs, and before the config which disables Prettier incompatible rules for all files.
Example:
import {eslintConfig} from 'eslint-config-un';
export default eslintConfig({
configs: {
/* ... */
},
extraConfigs: [
{
files: ['src/big-list-of-something.ts'],
rules: {
'perfectionist/sort-objects': 2,
'perfectionist/sort-object-types': 2,
},
},
// More flat configs ...
],
});
pluginRenames option)ESLint plugins are registered with an arbitrary user-provided prefix, such as unicorn or vue. Then the rule name are formed by combining the prefix with the rule name, for example unicorn/no-useless-undefined.
eslint-config-un provides the ability to change any registered plugin prefix. Additionally, some plugins are registered with a different prefix than their documentation suggests. If you would like to rename them back or rename some other plugins, you can use pluginRenames option, which is a map from the "canonical" prefixes to the user defined ones.
| Plugin | Suggested prefix | Our prefix | Reason |
|---|---|---|---|
typescript-eslint | @typescript-eslint | ts | More concise and convenient to use |
eslint-plugin-import-x | import-x | import | This plugin is a fork and is meant to replace the original plugin with import prefix |
eslint-plugin-n | n | node | Same ^ |
eslint-plugin-css | css | css-in-js | Conflicts with @eslint/css and our name better captures the essence of the plugin |
[!NOTE] If you rename a plugin, you still have to use the original prefix within
overrides,overridesAnyandextraConfigs. eslint-config-un will rename the rules accordingly for you.
[!WARNING] Renaming plugins and
eslint-disabledirectives If you rename a plugin, you will have to manually rename the rules withineslint-disable-*directives.
ESLint doesn't (yet?) have the ability to disable autofix for a rule by the user on per-rule basis. Our config attempts to provide this missing functionality by providing the limited ability to disable autofix for a rule as a whole or per-file and per-rule basis, but with a caveat that the rule will have disable-autofix prefix in its name. Additionally, we disable autofix for some rules by default, the list of which is available below.
To disable autofix for a rule, use an object notation for the rule entry:
import {eslintConfig} from 'eslint-config-un';
export default eslintConfig({
configs: {
unicorn: {
overrides: {
'unicorn/better-regex': {
severity: 2,
disableAutofix: 'prefixed', // or `unprefixed` or `true`/`false`
},
},
},
},
});
unprefixed: will disable autofix without changing the name of the rule, but it will be disabled for all files.prefixed: will create a plugin with disable-autofix prefix and copy this rule into it. The final rule is going to be disable-autofix/<rule-name> and <rule-name> will be disabled in the resulting flat config.true: use the default autofix disabling method, determined in disableAutofixMethod.default root option, which defaults to unprefixed.false: re-enable autofix for the rule (does nothing if autofix for this rule is disabled anywhere else with unprefixed method).Rules requiring type information, which are known to be performance-demanding, are enabled by default, and will be applied to the same files as ts config is applied to. It's just a little heads up; you should make your own decision whether to keep them enabled. Use configTypeAware to control to which files such rules will be applied to, if any.
We detect the version of the used frontend framework (Angular, Vue, Svelte, etc.) and apply the appropriate rules depending on the version. You can always manually specify the version using an appropriate option. Consult JSDoc of each config for more details.
By default, TypeScript rules will be enabled in .vue files if enforceTypescriptInScriptSection is set to true in vue's config options which in turn is automatically set to true if ts config is enabled. If you have .vue files authored in both TypeScript and JavaScript, use enforceTypescriptInScriptSection.{files,ignores} to manually specify TS & JS Vue components respectively. It is not currently possible to apply different ESLint rules depending on the value of lang attribute of <script> SFC section.
We support Angular versions from 13 to 19, all at once. This is achieved by generating an ESLint plugin specifically for the detected Angular version. Internally, @angular-eslint/eslint-plugin of versions 19 and 18, and @angular-eslint/eslint-plugin-template of versions 17 and 19 are used. We smartly enable the appropriate rules for each Angular version.
With this approach, we offer a unique ability to port the rules added in newer versions of @angular-eslint/eslint-plugin* and use them with older rules on older Angular codebases. Use portRules option to control which rules will be ported.
We use rules from several plugins to lint your React code. You will be able to choose whether you would like to use only eslint-plugin-react or @eslint-react/eslint-plugin, or both, which is the default.
If markdown config is enabled (which is the default), the same rules provided by other configs will be applied to code blocks (```lang ... ```) inside Markdown files. This works because under the hood the plugin @eslint/markdown that provides that functionality will create virtual files for each code block with the same extension as specified after ```.
But applying certain rules for code blocks might not be desirable because some of them are too strict for the code that won't be executed anyway or even unfixable (like missing imports). You can find the full list of disabled rules in src/configs/markdown.ts file.
ignoresSpecifies a list of globally ignored files. By default will be merged with our ignore patterns, unless overrideIgnores is set to true.
overrideIgnoresSet to true if you don't want ignores to be merged with our ignore patterns, which are ['**/dist'].
gitignoreBy default .gitignored files will be added to ignores list. Set to false to disable this behavior. You may also provide an object which configures eslint-config-flat-gitignore, which provides this functionality in the first place.
modeType of your project, either application (app, default) or library (lib). Will affect certain rules, actual list of which is written in JSDoc of this option.
disablePrettierIncompatibleRulesDisables rules that are potentially conflicting with Prettier. eslint-config-prettier is used under the hood, with a few exceptions. Defaults to true if prettier package is installed.
forceSeverityGlobally forces non-zero severity of all the rules configured by eslint-config-un (i.e. not within overrides, overridesAny or extraConfigs). This can also be configured per-config.
Use extraConfigs option. The configs provided there will be placed after all the eslint-config-un's configs, and before the config which disables Prettier incompatible rules for all files. These configs have a richer rules option, which allows you to apply more settings like overrides option does.
Alternatively, you can await the eslintConfig() function and then add your own flat configs to whatever place you like (we recommend use flat config composer from eslint-flat-config-utils package) for this purpose.
No! All the used plugins are direct dependencies of this package, you don't need to install them separately. We aim to update the dependencies within 1 month after their release. If anything, you can always override the dependency version using your package manager settings. Although, this might not be safe because we generate types for specific versions of the plugins, so the actual options of the rules might be different.
It's too much to document, so please have a look at the source code of our config. All the configs are placed inside src/configs directory.
We use local-pkg package to detect if a package is installed.
You can enable the debug mode by setting DEBUG=eslint-config-un environment variable when running ESLint command.
Alternatively, you can use @eslint/config-inspector to inspect the final config.
languageOptions: Key globals: Global AudioWorkletGlobalScope has leading or trailing whitespace.Install globals package as a dev dependency.
bundleDependencies featureIf you would like not to wait until the dependencies of eslint-config-un are updated or by whatever other reason you need to install a different version of a dependency, you can do that using your package manager's settings for all but the following packages:
| Package name | Reason |
|---|---|
eslint-plugin-prettier | Patched by us to enable formatting of "fenced code blocks" inside Markdown files |
eslint-plugin-no-type-assertion | Has outdated requirements of peer dependencies |
@angular-eslint/eslint-plugin-template@17.5.3 | Old version with outdated requirements of peer dependencies |
@angular-eslint/eslint-plugin@18.4.3 | ^ |
FAQs
A universal-ish ESLint config aiming to be reasonably strict and easily configurable.
The npm package eslint-config-un receives a total of 164 weekly downloads. As such, eslint-config-un popularity was classified as not popular.
We found that eslint-config-un demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
MCP spec updated with structured tool output, stronger OAuth 2.1 security, resource indicators, and protocol cleanups for safer, more reliable AI workflows.
Security News
More than half of CISOs now manage 10+ security areas, often with few legal safeguards and short tenures, yet continue to secure budgets and higher pay.
Security News
Libxml2’s solo maintainer drops embargoed security fixes, highlighting the burden on unpaid volunteers who keep critical open source software secure.