ember-template-lint-plugin-prettier

5.0.0 verified Sat Apr 25 auth: no javascript

A plugin for ember-template-lint that integrates Prettier to lint Handlebars/Glimmer templates. Current stable version is 5.0.0, released in 2023, requiring ember-template-lint >=4.0.0 and Prettier >=3.0.0. Release cadence is irregular with major version bumps for breaking changes. Unlike manual formatting, it automatically compares templates against Prettier output, enforcing consistent code style. It supports only a single rule and is ESM-only from v4. Recommended for Ember.js projects using both ember-template-lint and Prettier.

Common errors

error Cannot find module 'ember-template-lint-plugin-prettier' ↓

cause Plugin not installed or not in node_modules.

fix

Run npm install --save-dev ember-template-lint-plugin-prettier

error Missing peer dependencies: prettier@>=3.0.0 ↓

cause Prettier version is too old or not installed.

fix

Update prettier: npm install prettier@^3.0.0

error Rule 'prettier' was not found. Did you forget to load a plugin? ↓

cause Plugin not specified in the `plugins` array in .template-lintrc.js.

fix

Add plugins: ['ember-template-lint-plugin-prettier'] to your config.

Warnings

breaking v5 requires Prettier >=3.0.0; Prettier v2 is no longer supported. ↓

fix Upgrade Prettier to v3: `npm install prettier@^3.0.0`

breaking v4 drops CommonJS support; plugin is ESM-only. Requires Node >=12 and ember-template-lint v4. ↓

fix Ensure your project uses ESM or update to Node >=12 and ember-template-lint v4.

breaking v3 drops Node 10 and 15 support. ↓

fix Upgrade Node to >=12 or use v2 if needed.

deprecated The 'prettier' rule no longer accepts options; use Prettier config files (e.g., .prettierrc) instead. ↓

fix Remove options from rule config and configure Prettier via .prettierrc or package.json.

gotcha Plugin uses the locally installed Prettier, not any global one. Ensure prettier is in devDependencies. ↓

fix Install prettier as a dev dependency: `npm install --save-dev prettier`

Install

npm install ember-template-lint-plugin-prettier

yarn add ember-template-lint-plugin-prettier

pnpm add ember-template-lint-plugin-prettier

Imports

plugin

wrong

module.exports = { plugins: ['ember-template-lint-plugin-prettier/prettier'] };

correct

module.exports = { plugins: ['ember-template-lint-plugin-prettier'] };

Plugin is loaded by name; no import statement needed. Use the string identifier in the .template-lintrc.js config.

recommended config

wrong

extends: ['recommended', 'plugin:prettier/recommended']

correct

extends: ['recommended', 'ember-template-lint-plugin-prettier:recommended']

Use the correct scoped config name; incorrect names will be silently ignored.

rule
wrong
```
rules: { 'prettier/prettier': true }
```
correct
```
rules: { 'prettier': true }
```
The rule is named 'prettier', not 'prettier/prettier'. Setting to true applies the default config.

Quickstart

Configures ember-template-lint to use the prettier plugin with recommended rules.

// .template-lintrc.js
'use strict';

module.exports = {
  plugins: ['ember-template-lint-plugin-prettier'],
  extends: ['recommended', 'ember-template-lint-plugin-prettier:recommended']
};