eslint-config
Sprii eslint configurations. Based off https://github.com/moxystudio/eslint-config.
Installation
$ npm install --save-dev eslint @sprii/eslint-config
Additional dependencies that need to be installed per addon:
react addon: $ npm install --save-dev eslint-plugin-react@^3.13.0
This config was tested with eslint@^4.3.0
and the specific version ranges for plugins. Use other versions at your own risk. I will try to keep this project up to date with the changes of eslint
and the plugins used here.
Usage
First you need to choose the ECMAScript version you want to target: es5
, es6
, es7
or es8
.
Then enhance it with one or more addons:
-
browser
- If you are going to develop code for the browser -
node
- If you are going to develop code for NodeJS -
es6-modules
- If you are going to use ES6 import & export -
react
- If you are going to use React and JSX (requires )
Finally, simply create a .eslintrc.json
file with the chosen base configuration and addons. Feel free to override rules you won't agree with. You can look at some examples bellow.
Alternatively, you can make your own configuration by using the set of rules individually. If you're interested in doing that, you can check es5.js
to see how it is done.
Examples
Cutting edge ES6 with modules in the browser, using react:
{
"root": true,
"extends": [
"@sprii/eslint-config/es6",
"@sprii/eslint-config/addons/es6-modules",
"@sprii/eslint-config/addons/browser",
"@sprii/eslint-config/addons/react"
]
}
Cutting edge ES6 with modules in NodeJS (requires babel or similar):
{
"root": true,
"extends": [
"@sprii/eslint-config/es6",
"@sprii/eslint-config/addons/es6-modules",
"@sprii/eslint-config/addons/node"
]
}
Use ES6 in NodeJS without any transpiler:
{
"root": true,
"extends": [
"@sprii/eslint-config/es6",
"@sprii/eslint-config/addons/node"
]
}
.. and if you are programming against NodeJS v4 please use:
{
"root": true,
"extends": [
"@sprii/eslint-config/es6",
"@sprii/eslint-config/addons/node"
"@sprii/eslint-config/addons/node-v4-es6"
]
}
Good old ES5 in NodeJS:
{
"root": true,
"extends": [
"@sprii/eslint-config/es5",
"@sprii/eslint-config/addons/node"
]
}
Note that by setting root
to true, we ensure that no ancestor configuration is used which also improves eslint
performance because no more file lookups need to be done.
File name convention
If your file exports a single class, your filename should be exactly the name of the class. For other cases, the name of the file should be the same as the default exports (prefer camelCase).