Xtra UI ESLint Configuration

This package contains Xtra UI ESLint configurations for Typescript and TSX projects. ESLint is used for enforcement of code quality across Xtra UI applications.

NOTE: The Xtra UI 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 xtra-ui-prettier-config for integrating prettier into your application.

Installation

From the root of your package, install the Xtra UI configuration:

yarn add --dev xtra-ui-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 Xtra UI 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:  [ 'xtra-ui-eslint-config/ts' ],
    parserOptions:  {
        project: "./tsconfig.json",
    },
    env: {
        browser: true
    }
};

TSX Projects: Extend from xtra-ui-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.