eslint support for bud.js

Install @roots/bud-eslint to your project.

Yarn:

yarn add @roots/bud-eslint --dev

npm:

npm install @roots/bud-eslint --save-dev

For general information on configuring eslint see the official Eslint user guide.

You can configure Stylelint in two ways:

• Using a eslint config file
• Employing the bud.eslint API

You can configure eslint using a eslint config file.

bud.js allows for you to write your eslint config in CommonJS, ESM, TypeScript, JSON or YML. This file should be placed in the root of your project or the project ./config directory.

export default {
  extends: [`@roots/bud-eslint/config`],
  rules: { "no-console": `error` },
};

You can configure eslint directly in your bud.js config using the bud.eslint API.

bud.eslint
  .extends([`@roots/eslint-config`])
  .setRules({ "no-console": `error` })
  .setFailOnError(bud.isProduction)
  .setFailOnWarning(false)
  .setFix(true);

You can extend a eslint config by passing an array of eslint config files to bud.eslint.extends.

bud.eslint.extends([`@roots/bud-eslint/config`]);

You can set eslint rules by passing an object to bud.eslint.setRules.

bud.eslint.setRules({ "no-descending-specificity": null });

By default, eslint will fail on error in production mode. You can change this behavior by setting bud.eslint.failOnError to false.

bud.eslint.setFailOnError(false);

By default, eslint will not fail on warning. You can change this behavior by setting bud.eslint.failOnWarning to true.

bud.eslint.setFailOnWarning(true);

By default, eslint will not fix errors. You can change this behavior by setting bud.eslint.fix to true.

bud.eslint.setFix(true);

There is a recommended eslint configuration available for you to use as a starting point.

npm install @roots/eslint-config --save-dev

Once installed you can add it to the extends array in your eslint config:

module.exports = {
  root: true,
  extends: ["@roots/eslint-config"],
};

Contributions are welcome from everyone.

We have contribution guidelines to help you get started.

@roots/bud-eslint is licensed under MIT.

Keep track of development and community news.

• Join us on Roots Slack by becoming a GitHub sponsor
• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter

Bud is an open source project and completely free to use.

However, the amount of effort needed to maintain and develop new features and projects within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider sponsoring Roots.