eslint-config-vazco

eslint-config-vazco

ESLint shareable config with rules used by Vazco.eu in Meteor/React projects

Install

For ESLint 4.x

To install simply add this config (along with ESLint and required dependencies) to your project dev-dependencies:

npm install --save-dev babel-eslint
npm install --save-dev eslint
npm install --save-dev eslint-config-vazco
npm install --save-dev eslint-plugin-babel
npm install --save-dev eslint-plugin-react
npm install --save-dev eslint-plugin-vazco

# If you want to use prettier
npm install --save-dev prettier
npm install --save-dev eslint-plugin-prettier
npm install --save-dev eslint-config-prettier

Ready to use one-liner (for default config):

npm i -D babel-eslint eslint eslint-config-vazco eslint-plugin-babel eslint-plugin-react eslint-plugin-vazco

Ready to use one-liner (for prettier config):

npm i -D babel-eslint eslint eslint-config-prettier eslint-config-vazco eslint-plugin-babel eslint-plugin-prettier eslint-plugin-react eslint-plugin-vazco prettier

Previous ESLint versions

ESLint 2.x

If you want to use this config with ESLint 2.x (required e.g. for Node 0.10) you can install config for version 1.x:

npm i -D eslint@2 eslint-config-vazco@1 babel-eslint@6 eslint-plugin-babel@3 eslint-plugin-react@5

ESLint 3.x

We strongly recommend to upgrade to ESLint 4, but if you must you can use older dependencies and config from 2.x branch:

npm i -D eslint@3 babel-eslint@7 eslint-config-vazco@2 eslint-plugin-babel@4 eslint-plugin-react@6 eslint-plugin-vazco@1

Usage

Extend your project ESLint rules with our config. This can be done in few ways:

.eslintrc / .eslintrc.json

{
    "extends": "vazco",
    "rules": {
        // custom project rules
    }
}

.eslintrc.yaml

extends:
  - vazco

rules:
  // custom project rules

package.json

{
    "eslintConfig": {
        "extends": "vazco"
    }
}

Alternative config - vazco/prettier

Prettier is an opinionated code formatter: it removes all styling and enforces outputted code to use a consistent style.

Usage is the same as in examples above, just replace "extends": "vazco" with "extends": "vazco/prettier".

{
    "extends": "vazco/prettier"
}

This config is more strict, and using eslint --fix will completely reformat your code using prettier.

Prettier workflow

Introducing prettier to project can be problematic. To avoid merge conflicts, all active branches should reformat code at the same time.

Later on code could be --fixed on every commit, with tools like lint-staged and pre-commit or husky

Changelog

All changes introduces in the config are tracked inside changelog file.

How to change the rules

All information regarding making changes in the config and versioning details can be found in contributing file.

Please read them before opening a Pull Request or suggesting a change.

Licence

MIT. Copyright (c) Vazco.eu.

Changelog

3.1.1

• Updated dependencies:
  • babel-eslint@8.2.1
  • eslint@4.15.0
  • eslint-config-prettier@2.9.0
  • eslint-plugin-prettier@2.4.0
  • eslint-plugin-react@7.5.1
  • prettier@1.10.1