eslint-plugin-gestalt

Installation

You'll first need to install ESLint, then install eslint-plugin-gestalt:

``bash
$ npm install eslint --save-dev
$ npm install eslint-plugin-gestalt --save-dev
`

OR

`bash
$ yarn add --dev eslint
$ yarn add --dev eslint-plugin-gestalt
`

Note: If you installed ESLint globally (using the -g flag) then you must also install eslint-plugin-gestalt globally.

Usage

Add gestalt to the plugins section of your .eslintrc configuration file. You can omit the eslint-plugin- prefix:

`json
{
"plugins": ["gestalt"]
}
`

Then configure the rules you want to use under the rules section.

`json
{
"rules": {
"gestalt/rule-name": 2
}
}
`

Supported Rules

Visit our ESLint rules documentation page

Development

New rules should be developed TDD-style by testing against simplified test cases first. See the \*.test.js files and fixtures for examples. Once tests pass, you can check the rules against a project using gestalt through yarn link. For example:

`bash
cd ~/code/gestalt/packages/gestalt-eslint
yarn link
cd ~/code/project-using-gestalt
yarn link eslint-plugin-gestalt
`

You can now add any new rules to the project's eslint config and run eslint against the project to test your changes.

Remember to unlink when you're done!

`bash
cd ~/code/project-using-gestalt
yarn unlink eslint-plugin-gestalt
``