Lint to the Future

2.6.4 verified Fri May 01 auth: no javascript

Lint to the Future (LTTF) v2.6.4 is a tool that helps progressively enable lint rules by adding file-based ignore directives to existing violations, then tracking cleanup via a dashboard. It supports ESLint, Ember templates, stylelint via plugins (e.g., lint-to-the-future-eslint). Active development with monthly releases. Unlike blanket ignore configs, it adds temporary per-file ignores, allowing new files to adhere to rules while old files are fixed incrementally. Requires Node >= 18.

Common errors

error Error: Cannot find module 'lint-to-the-future-eslint' ↓

cause ESLint plugin not installed.

fix

Run: npm install --save-dev lint-to-the-future-eslint

error TypeError: linter is not a function ↓

cause Missing or misconfigured linter (e.g., eslint not installed).

fix

Ensure the corresponding linter package is installed and configured (e.g., npm install --save-dev eslint).

error Warning: No plugins found. Lint to the Future needs at least one plugin to run. ↓

cause No lint-to-the-future-* plugin installed.

fix

Install a plugin like lint-to-the-future-eslint.

Warnings

breaking Requires Node >= 18. Older versions may crash with syntax errors. ↓

fix Update Node.js to v18 or later.

gotcha The 'ignore' command only handles errors, not warnings. Warnings will be ignored. ↓

fix Configure your linter to treat warnings as errors if needed.

deprecated In v2.5.0, the 'files' route was renamed to 'rule'. Old dashboard links may break. ↓

fix Update references from '/files' to '/rule' in your dashboard configuration.

gotcha Plugins must be installed locally (not globally) and named 'lint-to-the-future-*'. Autoloading may miss plugins with different prefixes. ↓

fix Ensure plugin packages start with 'lint-to-the-future-' and are in node_modules.

breaking The --previous-results flag output format changed in v2.5.1 to fix a bug. Custom scripts relying on old format may break. ↓

fix Update any parsing logic for --previous-results output.

Install

npm install lint-to-the-future

yarn add lint-to-the-future

pnpm add lint-to-the-future

Imports

lint-to-the-future
wrong
```
npx lint-to-the-future ignore-eslint
```
correct
```
npx lint-to-the-future ignore
```
CLI tool; run via npx or install globally. No programmatic API.

LTTF ignore

wrong

npx lint-to-the-future --ignore

correct

npx lint-to-the-future ignore

Use 'ignore' subcommand, not a flag.

LTTF dashboard
wrong
```
npx lint-to-the-future dashboard
```
correct
```
npx lint-to-the-future generate
```
Generate dashboard HTML using 'generate' subcommand.

Quickstart

Initialize a project with lint-to-the-future, add file-based ignores for existing ESLint errors, and generate a dashboard.

mkdir my-project && cd my-project
npm init -y
npm install --save-dev lint-to-the-future lint-to-the-future-eslint eslint
npx eslint --init
# Create a file with lint errors: echo 'var x = 1' > index.js
npx lint-to-the-future ignore
# Now run eslint again, no errors
# Generate dashboard:
npx lint-to-the-future generate --output-dir ./dashboard
# Open ./dashboard/index.html