ESLint config

Installation

$ npm install --save-dev eslint eslint-plugin-import @namics/eslint-config

Usage Typescript (recommended)

• @namics/eslint-config/configurations/typescript-browser - typescript + browser
• @namics/eslint-config/configurations/typescript-react - typescript + react
• @namics/eslint-config/configurations/typescript-node - typescript + node

package.json

{
  "scripts": {
    "lint:ts": "eslint . --ext .jsx,.js,.ts,.tsx"
  }
}

Enabling ESLint on TS files in VSCode

You need to update the eslint.validate setting to:

"eslint.validate": [
  "javascript",
  "javascriptreact",
  "typescript",
  "typescriptreact"
]

Usage ES8 (ES2017)

• @namics/eslint-config/configurations/es8-browser - ES8 + browser
• @namics/eslint-config/configurations/es8-react - ES8 + react
• @namics/eslint-config/configurations/es8-node - ES8 + node

Usage ES7 (ES2016)

• @namics/eslint-config/configurations/es7-browser - ES7 + browser (deprecated)
• @namics/eslint-config/configurations/es7-react - ES7 + react (deprecated)
• @namics/eslint-config/configurations/es7-node - ES7 + node

Usage ES6 (ES2015) - deprecated

• @namics/eslint-config/configurations/es6-browser - ES6 + browser (deprecated)
• @namics/eslint-config/configurations/es6-react - ES6 + react (deprecated)
• @namics/eslint-config/configurations/es6-node - ES6 + node (deprecated)

Usage with Prettier

• configuration with prettier

.eslintrc.js (add globals here if needed)

module.exports = {
  extends: require.resolve('@namics/eslint-config/configurations/es8-browser.js'),
};

.eslintignore

/.idea/
/node_modules/

package.json

"scripts": {
  "lint": "npm run lint:js",
  "lint:js": "eslint ."
},

then run npm run lint

Example usage in project tree

• .eslintrc.js (es8-react)
• .eslintignore
• src
  • app.jsx
• test
  • .eslintrc.js (es8-node)
  • index.js
• scripts
  • .eslintrc.js (es6-node)
  • index.js

Documentation

• Best practices (ES5/6/7/8)
• Style (ES5/6/7/8)
• Variables (ES5/6/7/8)
• Errors (ES5/6/7/8)
• Node (ES5/6/7/8)
• ES6 (ES6/7/8)
• ES8 (ES8)
• Imports (ES6/7/8)
• React (ES6/7/8)
• React A11y (ES6/7/8)
• React hooks (ES6/7/8)
• Typescript (typescript)

Build release

1. Create feature or bugfix branch based on master
2. Make changes and create pull request, add reviewer, wait for approval
3. Merge pull request into master
4. Prepare release notes, adjust package.json to next version ([Semantic Versioning](semantic versioning))
5. Run npm publish (locally) to create npm version
6. Create and push git tag for version
7. Add release notes on GitHub

Thanks to

• Merkle.
• Namics.
• ESLint for ESLint and the documentation eslint.org
• Walmart for sharing their config in eslint-config-walmart
• AirBnB for sharing their eslint config in JavaScript Style Guide

License

MIT License

Changelog

Please see the Releases