pug-lint-vue

library0.4.0jsnpmunverified

A CLI tool that lints Pug (formerly Jade) templates inside Vue single-file components (.vue). It wraps the pug-lint library and scans template tags with 'lang="pug"' attribute. This is the only package that specifically targets Pug templates in Vue files, as opposed to generic Pug or Vue linting tools. The current stable version is 0.4.0, though the project appears unmaintained since 2018, with no recent releases or activity. It requires pug-lint as a peer dependency. For CI or pre-commit hooks on Vue + Pug projects, it may still function but lacks active support.

testing

npm install pug-lint-vue

github ↗package ↗

INSTALL

IMPORT

SIG · PUG-LINT-VUE

pug-lint-vue

testingjavascriptv0.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default export (CLI)

✓ npx pug-lint-vue [options] <file ...>

✗ npm install -g pug-lint-vue

The package is a CLI tool; it does not export a programmatic API. Use npx or global install to run.

require('pug-lint-vue')

✓ N/A - no programmatic API exported

✗ const linter = require('pug-lint-vue');

Do not attempt to require() this package; it only provides a CLI binary.

Configuration (extends pug-lint config)

✓ Create .pug-lintrc in project root (JSON or YAML)

✗ Overrides inside .eslintrc or .pug-lintrc.json not recognized if malformed

Configuration follows pug-lint format; pug-lint-vue does not add extra config options. See pug-lint docs.

Installs both packages, configures basic pug-lint rules, and runs the CLI against a directory of .vue files.

npm install pug-lint-vue pug-lint # Create .pug-lintrc.json with sample rules: # { # "disallowMultipleSpaces": true, # "requireSpaceAfterCodeOperator": true # } # Lint all .vue files in src/: npx pug-lint-vue src/ # Or specify files directly: npx pug-lint-vue src/App.vue src/components/

pug-lint-vue --version

Debug

Known issues

deprecatedPackage has not been updated since 2018; may be incompatible with newer versions of pug-lint or Node.js.

fix

Consider migrating to other tooling that supports Vue 3 + Pug, e.g., eslint-plugin-vue-pug (if available) or manually lint Pug templates.

affects: >=0.4.0

gotchaDoes not support Vue 3 or Composition API; only works with Vue 2 single-file components.

fix

For Vue 3 projects, use a different linting approach such as custom ESLint rules or regex-based checks.

affects: all

gotchaRequires pug-lint as a peer dependency; pug-lint itself is no longer actively maintained.

fix

Install pug-lint explicitly: npm install pug-lint

affects: all

breakingRemoved dependency on pug-lint in version 0.3.0? (unclear changelog)

fix

Always install pug-lint separately.

affects: >=0.3.0

Errors

Common errors & fixes

Error: Cannot find module 'pug-lint'

Missing peer dependency pug-lint

fix

npm install pug-lint

pug-lint-vue: command not found

Package not installed globally or not in PATH

fix

Run via npx or install globally: npm install -g pug-lint-vue

TypeError: Cannot read property 'someRule' of undefined

pug-lint version incompatibility; pug-lint-vue expects a specific rule format

fix

Install a specific version of pug-lint that works, e.g., npm install pug-lint@2.6.0

Unexpected token: 'pug' (or parse errors with Vue template syntax)

The tool ONLY lints templates with lang="pug"; other templates are ignored but may be parsed as JavaScript incorrectly

fix

Ensure your .vue template <template> tag explicitly has lang="pug". Remove or ignore other templates.

Upgrade

Version history

0.4.0latest on npm

Audit

Dependencies

pug-lintrequiredpeer dependency; pug-lint does the actual linting of Pug syntax

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/sourceboat/pug-lint-vue ↗

packagehttps://www.npmjs.com/package/pug-lint-vue ↗