lint-to-the-future-ember-template

4.1.0 verified Fri May 01 auth: no javascript

lint-to-the-future-ember-template is a plugin for lint-to-the-future that integrates with ember-template-lint to allow progressive adoption of lint rules in Ember.js projects. It generates and manages ignore files for template linting, enabling teams to incrementally fix lint errors without blocking CI. Current stable version is 4.1.0, released January 2026, with active development and regular major releases (v4.0.0 dropped support for ember-template-lint v2 and added v7 support). Key differentiators: seamless integration with lint-to-the-future ecosystem, automatic ignore insertion at top of template tags, multi-line disable support, and respect for .gitignore. ESM-only since v3.0.0, requires Node >=18 (dropped Node 14 in v2, Node 16 in v3).

Common errors

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

cause Package not installed or incorrect import path.

fix

Run npm install lint-to-the-future-ember-template. Ensure import path is correct: 'lint-to-the-future-ember-template'

error TypeError: lttfEmberTemplate is not a constructor ↓

cause Attempting to use class with 'new' on default import, but default export is not a class.

fix

Use import plugin from 'lint-to-the-future-ember-template' without 'new'.

error Error [ERR_REQUIRE_ESM]: require() of ES Module ↓

cause Using CommonJS require() on an ESM-only module (v3+).

fix

Switch to import syntax. If you must use CommonJS, use dynamic import: import('lint-to-the-future-ember-template')

Warnings

breaking v3.0.0 moved to ESM only with type:module. CommonJS require() will fail. ↓

fix Use import syntax. Set type:module in package.json or use .mjs extension.

breaking v4.0.0 dropped support for ember-template-lint v2. If your project uses ember-template-lint v2, this plugin will not work. ↓

fix Upgrade ember-template-lint to v3, v4, v5, v6, or v7.

deprecated Node 16 support dropped in v3.0.0, Node 14 dropped in v2.0.0. ↓

fix Use Node 18, 20, or >=22 as specified in engines.

gotcha If you are using ember-template-lint v7, ensure you use lint-to-the-future-ember-template >=4.0.0. ↓

fix Upgrade to v4.0.0 or later.

breaking v1.0.0 dropped support for Node <14. ↓

fix Use Node >=14 (but recommended Node >=18 for latest versions).

Install

npm install lint-to-the-future-ember-template

yarn add lint-to-the-future-ember-template

pnpm add lint-to-the-future-ember-template

Imports

default export

wrong

const plugin = require('lint-to-the-future-ember-template')

correct

import plugin from 'lint-to-the-future-ember-template'

ESM-only since v3.0.0; CommonJS require() fails

type import

import type { LintToTheFutureEmberTemplateConfig } from 'lint-to-the-future-ember-template'

Types are included; use import type for TypeScript

Plugin class

wrong

import LintToTheFutureEmberTemplatePlugin from 'lint-to-the-future-ember-template'

correct

import { LintToTheFutureEmberTemplatePlugin } from 'lint-to-the-future-ember-template'

Named export, not default; common mistake

Quickstart

Shows how to configure lint-to-the-future-ember-template as a plugin in lint-to-the-future config file, using ESM imports. Assumes lint-to-the-future is installed.

// lint-to-the-future.config.js
import lttfEmberTemplate from 'lint-to-the-future-ember-template';

export default {
  plugins: [lttfEmberTemplate],
  // or using the class:
  // plugins: [new LintToTheFutureEmberTemplatePlugin()]
};

// Then run:
// npx lint-to-the-future ignore
// npx lint-to-the-future check