{"id":27264,"library":"pug-lint-vue","title":"pug-lint-vue","description":"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.","status":"deprecated","version":"0.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/sourceboat/pug-lint-vue","tags":["javascript","lint","linting","linter","pug","jade","vue"],"install":[{"cmd":"npm install pug-lint-vue","lang":"bash","label":"npm"},{"cmd":"yarn add pug-lint-vue","lang":"bash","label":"yarn"},{"cmd":"pnpm add pug-lint-vue","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency; pug-lint does the actual linting of Pug syntax","package":"pug-lint","optional":false}],"imports":[{"note":"The package is a CLI tool; it does not export a programmatic API. Use npx or global install to run.","wrong":"npm install -g pug-lint-vue","symbol":"default export (CLI)","correct":"npx pug-lint-vue [options] <file ...>"},{"note":"Do not attempt to require() this package; it only provides a CLI binary.","wrong":"const linter = require('pug-lint-vue');","symbol":"require('pug-lint-vue')","correct":"N/A - no programmatic API exported"},{"note":"Configuration follows pug-lint format; pug-lint-vue does not add extra config options. See pug-lint docs.","wrong":"Overrides inside .eslintrc or .pug-lintrc.json not recognized if malformed","symbol":"Configuration (extends pug-lint config)","correct":"Create .pug-lintrc in project root (JSON or YAML)"}],"quickstart":{"code":"npm install pug-lint-vue pug-lint\n# Create .pug-lintrc.json with sample rules:\n# {\n#   \"disallowMultipleSpaces\": true,\n#   \"requireSpaceAfterCodeOperator\": true\n# }\n# Lint all .vue files in src/:\nnpx pug-lint-vue src/\n# Or specify files directly:\nnpx pug-lint-vue src/App.vue src/components/","lang":"javascript","description":"Installs both packages, configures basic pug-lint rules, and runs the CLI against a directory of .vue files."},"warnings":[{"fix":"Consider migrating to other tooling that supports Vue 3 + Pug, e.g., eslint-plugin-vue-pug (if available) or manually lint Pug templates.","message":"Package has not been updated since 2018; may be incompatible with newer versions of pug-lint or Node.js.","severity":"deprecated","affected_versions":">=0.4.0"},{"fix":"For Vue 3 projects, use a different linting approach such as custom ESLint rules or regex-based checks.","message":"Does not support Vue 3 or Composition API; only works with Vue 2 single-file components.","severity":"gotcha","affected_versions":"all"},{"fix":"Install pug-lint explicitly: npm install pug-lint","message":"Requires pug-lint as a peer dependency; pug-lint itself is no longer actively maintained.","severity":"gotcha","affected_versions":"all"},{"fix":"Always install pug-lint separately.","message":"Removed dependency on pug-lint in version 0.3.0? (unclear changelog)","severity":"breaking","affected_versions":">=0.3.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"npm install pug-lint","cause":"Missing peer dependency pug-lint","error":"Error: Cannot find module 'pug-lint'"},{"fix":"Run via npx or install globally: npm install -g pug-lint-vue","cause":"Package not installed globally or not in PATH","error":"pug-lint-vue: command not found"},{"fix":"Install a specific version of pug-lint that works, e.g., npm install pug-lint@2.6.0","cause":"pug-lint version incompatibility; pug-lint-vue expects a specific rule format","error":"TypeError: Cannot read property 'someRule' of undefined"},{"fix":"Ensure your .vue template <template> tag explicitly has lang=\"pug\". Remove or ignore other templates.","cause":"The tool ONLY lints templates with lang=\"pug\"; other templates are ignored but may be parsed as JavaScript incorrectly","error":"Unexpected token: 'pug' (or parse errors with Vue template syntax)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}