PX Blue ESLint Configuration
This package contains PX Blue ESLint configurations for Typescript and TSX projects. ESLint is used for enforcement of code quality across PX Blue applications.
NOTE: The PX Blue ESLint configuration package is only compatible with TypeScript projects.
All ESLint rules enforcing code style have been disabled in favor of using prettier for code formatting. Refer to @pxblue/prettier-config for integrating prettier into your application.
Installation
From the root of your package, install the PX Blue configuration:
yarn add --dev @pxblue/eslint-config
You will also need to install the following peer dependencies:
yarn add --dev eslint eslint-config-prettier @typescript-eslint/eslint-plugin @typescript-eslint/parser
If your project is using React with the TSX file extension, you also need to install:
yarn add --dev eslint-plugin-react
Configuration
Add Linting Scripts
Add the following scripts to your package.json.
"scripts": {
"lint": "eslint \"src/**/**.ts\"",
"lint:fix": "eslint \"src/**/**.ts\" --fix",
}
TSX Projects: Make sure to include .tsx file extension in your lint commands (e.g.
eslint '**/**.{tsx,ts}')
The --fix flag will automatically attempt to fix reported errors. Leaving this off will report errors/warnings without attempting to fix them.
Import the Linting configuration
The PX Blue configuration needs to be imported into ESLint. Add the following .eslintrc.js to the root of your project.
module.exports = {
parser: '@typescript-eslint/parser',
extends: [ '@pxblue/eslint-config/ts' ],
parserOptions: {
project: "./tsconfig.json",
},
env: {
browser: true
}
};
TSX Projects: Extend from
@pxblue/eslint-config/tsx.
Usage
To lint all typescript files in your project, run yarn lint.
To automatically fix linting errors in your project, run yarn lint:fix or yarn lint --fix.