eslint-config-protect-me-from-my-stupidity

eslint-config-protect-me-from-my-stupidity

A very opinionated configuration for ESLint that shall protect you from your stupidity when writing JavaScript.

Usage

You can use this in your ESLint configuration file, like so:

import protectMeFromMyStupidity from 'eslint-config-protect-me-from-my-stupidity';

export default [
  ...protectMeFromMyStupidity()
];

The base configuration configures all core rules, as of 9.17.0, and all the rules for the following plugins (which are peer dependencies):

Plugin	Minimum Version
eslint-plugin-promise	7.2.1
eslint-plugin-import	2.31.0
@stylistic/eslint-plugin-js	2.12.1

ESLint is configured to parse code as the the latest version of ECMAScript and to treat all .js, .mjs and .jsx files as ES modules and .cjs files as CommonJS modules.

Configuration extensions

In addition to the base configuration you can use configuration extensions, these are available as seperate exports.

Name	Export	Required Plugins	Description
Node	and/from-writing-stupid-vue-components	eslint-plugin-vue@9.32.0	Introduces additional rules for .vue component files.
Web	and/from-writing-stupid-web-applications	-	Introduces additional rules for web code files.
Vue	and/from-writing-stupid-node-applications	eslint-plugin-n@17.15.1	Introduces additional rules for Node.js code files.

Please Note: The plugins required by the configuration extensions are optional peer dependencies, so if you aren't using a configuration extension you don't need to install its required plugins.

Configuration extensions can be configured to use your own file matching patterns instead of the defaults, like so:

import andFromWritingStupidWebApplications from 'eslint-config-protect-me-from-my-stupidity/and/from-writing-stupid-web-applications';

export default [
  ...andFromWritingStupidWebApplications([
    'src/ui/**/*.js'
  ])
];

Semantic versioning

This project follows a semantic versioning policy that aims not to surprise you.

Patch release

• Updating an existing rule that will result in ESLint reporting fewer errors.

Minor release

• Updating an existing rule that will result in ESLint reporting different or more errors.
• Adding a new rule.
• Removing support for a minor or patch version of ESlint or a plugin.

Major release

• Adding support for a new plugin.
• Removing support for a major version of ESLint or a plugin.
• Adding or removing configuration extensions.

Note: It is advised that you only take patch versions using tilde ranges.

Getting started

This project is available through the Node Package Manager (NPM), so you can install it like so:

npm install eslint-config-protect-me-from-my-stupidity --save-dev

Disclaimer

Finally, if you get offended by my use of the word stupid. It is just a joke.

Changelog

12.0.0 - 2025-01-07

Added

• Introduced the Web (and/from-writing-stupid-web-applications) configuration extension.
• Switched the promise/prefer-catch rule on in the base configuration.
• Switched the vue/slot-name-casing rule on in the Vue configuration extension, enforcing slot names to be kebab-case.
• Switched the vue/restricted-component-names rule off in the Vue configuration extension.

Changed

• Updated the base configuration to enable the JSX language feature for .jsx files.
• Updated the base configuration to enable implied global strict mode.
• Updated the base configuration and the configuration extensions to be a function. The configuration extensions enable developers to specify their own file matching patterns.
• Updated the minimum required eslint version to 9.17.0.
• Updated the minimum required eslint-plugin-promise version to 7.2.1.
• Updated the minimum required eslint-plugin-vue version to 9.32.0.
• Updated the minimum required eslint-plugin-n version to 17.15.1.
• Updated the minimum required @stylistic/eslint-plugin-js version to 2.12.1.