eslint-config-zillow-base

eslint-config-zillow-base

Zillow's base ESLint config (without React plugins), following our code conventions

Usage

To install with all necessary peerDependencies, use install-peerdeps:

npx install-peerdeps --dev eslint-config-zillow-base

All exported configs should be added to your ESlint configuration file extends. For example, in a JSON .eslintrc:

{
  "extends": "zillow-base"
}

"extends": "zillow-base"

Our default export contains all of our ESLint rules, including ECMAScript 6+ and Prettier.

"extends": ["zillow-base", "zillow-base/jest]

Jest-specific rules and environment added to the default export.

"extends": ["zillow-base", "zillow-base/mocha]

Mocha-specific rules and environment added to the default export.

prettier Editor Plugin Integration

Unfortunately, super-useful editor plugins like prettier-atom and prettier-vscode do not load Prettier settings from ESLint config, which is where we load our Prettier options from. To workaround this, add a .prettierrc.js or prettier.config.js file to your repo root with the following content:

module.exports = require('prettier-config-zillow');

Related

• Zillow's overarching ESLint config
• Zillow's Prettier config
• Zillow's Javascript code conventions

Development

Consider adding test cases if you're making complicated rules changes, like anything involving regexes. Perhaps in a distant future, we could use literate programming to structure our README as test cases for our .eslintrc?

You can run tests (from the repo root) with npm test.

You can make sure this module lints with itself using npm run lint (from the repo root).