convert-tslint-to-eslint

Convert a project from TSLint to ESLint

Usage

nx generate convert-tslint-to-eslint ...

By default, Nx will search for convert-tslint-to-eslint in the default collection provisioned in workspace.json.

You can specify the collection explicitly as follows:

nx g @nrwl/angular:convert-tslint-to-eslint ...

Show what will be generated without writing to disk:

nx g convert-tslint-to-eslint ... --dry-run

Examples

The following will first configure the project, myapp, the same way a new project is configured i.e. It will use Nx's new recommended ESLint config. By default, this also adds the existing TSLint configuration on top of the default ESLint config from Nx to continue checking what it checks today. This is done by migrating TSLint rules to their equivalent ESLint rules to the best of its abilities. Some TSLint rules may not have ESLint equivalents and will be reported during the conversion:

nx g convert-tslint-to-eslint myapp

If your TSLint config isn't extremely important to you, ignoring it makes this process more deterministic. Unlike the prior example, this will discard the existing TSLint configuration, meaning that the project will only have the Nx's latest recommended ESLint configuration which may be good enough for some workspaces:

nx g convert-tslint-to-eslint myapp --ignoreExistingTslintConfig=true

By default, this process removes the TSLint related dependencies and configuration once no more projects use TSLint. This can be disabled with the following flag to keep TSLint related dependencies and configuration in the repo:

nx g convert-tslint-to-eslint myapp --removeTSLintIfNoMoreTSLintTargets=false

Options

ignoreExistingTslintConfig

Default: false

Type: boolean

If true we will not use existing TSLint config as a reference, we will just reset the project with the latest recommended ESLint config

project

Type: string

The name of the Angular project to convert. Please note, if the project is an Angular app with an associated Cypress e2e project, we will also attempt to convert that.

removeTSLintIfNoMoreTSLintTargets

Default: true

Type: boolean

If this conversion leaves no more TSLint usage in the workspace, it will remove TSLint and related dependencies and configuration