{"id":25704,"library":"gulp-pug-linter","title":"gulp-pug-linter","description":"Gulp plugin for linting Pug (formerly Jade) template files using pug-lint. Stable version 1.5.0 (2021-02-06), no longer actively maintained (last release 2021). It wraps pug-lint with Gulp streams, supporting custom reporters, fail-after-error mode, and silence-on-success. Key differentiators: no-frills wrapper that works with existing pug-lint configuration files (.pug-lintrc, .pug-lint.json, package.json). Requires Node >=10.x. Alternatives: direct pug-lint CLI or other Gulp linters.","status":"maintenance","version":"1.5.0","language":"javascript","source_language":"en","source_url":"https://github.com/ilyakam/gulp-pug-linter","tags":["javascript","gulp","lint","pug","plugin","jade"],"install":[{"cmd":"npm install gulp-pug-linter","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-pug-linter","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-pug-linter","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Gulp plugin interface","package":"gulp","optional":true},{"reason":"Core linting engine","package":"pug-lint","optional":false}],"imports":[{"note":"Package does not ship ESM; CommonJS only. Use require().","wrong":"import pugLinter from 'gulp-pug-linter';","symbol":"default","correct":"const pugLinter = require('gulp-pug-linter');"},{"note":"Default export, not named export. Use require() directly.","wrong":"const { pugLinter } = require('gulp-pug-linter');","symbol":"pugLinter","correct":"const pugLinter = require('gulp-pug-linter');"},{"note":"Must pipe through a Gulp stream, not call pugLinter standalone.","wrong":"gulp.task('lint', () => pugLinter.pipe())","symbol":"gulp.task","correct":"gulp.task('lint', () => gulp.src().pipe(pugLinter()))"}],"quickstart":{"code":"const gulp = require('gulp');\nconst pugLinter = require('gulp-pug-linter');\n\ngulp.task('lint:pug', () =>\n  gulp\n    .src('./**/*.pug')\n    .pipe(pugLinter({ reporter: 'default', failAfterError: true }))\n);","lang":"javascript","description":"Gulp task to lint all .pug files using default reporter and fail on errors."},"warnings":[{"fix":"Upgrade Node.js to version 10 or higher.","message":"Node.js engine requirement >=10.x (dropped support for 8.x and below)","severity":"breaking","affected_versions":">=1.4.0"},{"fix":"Use options object, e.g., pugLinter({ reporter: 'default', failAfterError: true }).","message":"API changed in v1.0.0: new options object format (reporter, failAfterError) replaces old separate reporter() method","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Migrate to new options object API: pugLinter({ reporter: 'default', failAfterError: true }).","message":"Separate reporter() stream handler (including 'fail' flag) deprecated since v0.7.0 and removed in v1.0.0","severity":"deprecated","affected_versions":">=0.7.0 <1.0.0"},{"fix":"Always provide a reporter (e.g., 'default') when using failAfterError.","message":"If no reporter is specified and failAfterError is true, build fails without displaying lint errors","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Ensure reporter value is valid: 'default', a string name, or a reporter function.","message":"Invalid reporter value falls back to 'default' reporter silently (with warning printed to console)","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'npm install gulp-pug-linter --save-dev'","cause":"Package not installed or installed as devDependency but not in node_modules","error":"Error: Cannot find module 'gulp-pug-linter'"},{"fix":"Use 'const pugLinter = require('gulp-pug-linter');' instead of import or destructuring.","cause":"Using import statement in CommonJS environment or wrong import style","error":"TypeError: pugLinter is not a function"},{"fix":"Create a .pug-lintrc.json file with pug-lint rules, e.g., { \"extends\": \"clockwork\" }","cause":"Missing .pug-lintrc or equivalent configuration file in project root","error":"Error: Couldn't find pug-lint configuration file. See pug-lint's documentation for more info."}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}