@windyroad/xo-config

This package provides a shareable configurations for:

• XO, which is a wrapper around ESLint, and
• markdownlint-cli2

It provides a consistent and opinionated set of rules for JavaScript and TypeScript projects.

Installation

To use this configuration in your project, you can install it via npm:

npm install --save-dev @windyroad/xo-config

Usage

XO

To use this configuration in your project, you can add it to your package.json file:

{
  "xo": "@windyroad/xo-config"
}

Alternatively, you can create an .xo-config.js file in the root of your project and export the configuration:

'use strict';
const config = require("@windyroad/xo-config")
module.exports = config

markdownlint-cli2

If you're using markdownlint-cli2, you can also use the shared configuration provided by this package. To use it, create a .markdownlint-cli2.cjs file in the root of your project and export the configuration:

'use strict';
const config = require("@windyroad/xo-config/src/markdownlint-cli2.cjs")
module.exports = config

Configuration

This configuration extends the recommended TypeScript flavour error configuration from the eslint-config-xo-typescript package. It also includes the following plugins:

• eslint-plugin-no-secrets
• eslint-plugin-jsdoc
• eslint-plugin-jsonc

The configuration also includes the following rules:

• no-secrets/no-secrets: Enforces the use of detect-secrets to prevent secrets from being committed to version control.
• jsdoc/no-undefined-types: Disables the requirement to define types for JSDoc comments.
• jsdoc/require-param-type: Disables the requirement to define types for JSDoc parameters.
• jsdoc/require-returns-type: Disables the requirement to define a return type for JSDoc comments.

Contributing

Contributions are welcome! Please read the contributing guidelines for more information.

License

@windyroad/xo-config is lovingly licensed under the MIT License. ❤️