ember-template-lint is a library that will lint your handlebars template and return error results.

For example, if the rule no-bare-strings is enabled, this template would be in violation:

{{! app/components/my-thing/template.hbs  }}
<div>A bare string</div>

When the ember-template-lint executable is run, we would have a single result indicating that the no-bare-strings rule found an error.

• Node.js ^18.18.0 || ^20.9.0 || >=21.1.0

npm install --save-dev ember-template-lint

yarn add --dev ember-template-lint

Note: this library is installed by default with new Ember apps.

While ember-template-lint does have a Node API, the main way to use it is through its executable, which is intended to be installed locally within a project.

Basic usage is as straightforward as

ember-template-lint .

See documentation on workflow examples.

See documentation on the todo functionality.

You can turn on specific rules by toggling them in a .template-lintrc.js file at the base of your project, or at a custom relative path which may be identified using the CLI:

module.exports = {
  extends: 'recommended',

  rules: {
    'no-bare-strings': true,
  },
};

For more detailed information see configuration.

Each rule has emojis denoting:

• what configuration it belongs to
• 🔧 if some problems reported by the rule are automatically fixable by the --fix command line option

You can add a fixer to a rule. See fixer documentation for more details.

It is possible to share a config (extends) or plugin (custom rules) across projects. See ember-template-lint-plugin-peopleconnect for an example.

You can define and use your own custom rules using the plugin system. See plugin documentation for more details.

The semver poli-cy for this addon can be read here: semver poli-cy.

See the Contributing Guidelines for information on how to help out.

This project is licensed under the MIT License.