Registry / devops / vite-plugin-vue-pug-lint

vite-plugin-vue-pug-lint

library1.1.0jsnpmunverified

vite-plugin-vue-pug-lint is a Vite plugin that integrates pug-lint into Vue single file components (SFCs), providing linting for Pug templates during development and build. The current version 1.1.0 is stable and supports Vite 2.x and pug-lint 2.6.0 as peer dependencies. It is a direct replacement for the Webpack-based vue-pug-lint-loader, offering similar functionality with a simple plugin API. The plugin allows custom configuration via configFile option and filter patterns for include/exclude. It ships TypeScript types and is actively maintained.

devops

npm install vite-plugin-vue-pug-lint

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-VUE-PU

vite-plugin-vue-pug-lint

devopsjavascriptv1.1.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

✓ import pugLint from 'vite-plugin-vue-pug-lint'

✗ const pugLint = require('vite-plugin-vue-pug-lint')

ESM-only; no CommonJS export

default

✓ import pugLint from 'vite-plugin-vue-pug-lint'

✗ const { pugLint } = require('vite-plugin-vue-pug-lint')

Default export, not named export

pugLint

✓ import { pugLint } from 'vite-plugin-vue-pug-lint'

✗ import pugLint from 'vite-plugin-vue-pug-lint'

Named export also available since v1.0.0

Shows how to install and configure vite-plugin-vue-pug-lint with custom options in a Vite project using Vue.

// vite.config.js import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; import pugLint from 'vite-plugin-vue-pug-lint'; export default defineConfig({ plugins: [ pugLint({ configFile: 'path/to/.pug-lintrc', // optional include: /\.vue$/, // default exclude: /node_modules/, // default }), vue(), ], }); // Then configure pug-lint rules as usual, e.g., .pug-lintrc.json: // { "disallowIdLiterals": true }

Debug

Known issues

breakingRequires Vite 2.x; not compatible with Vite 3+

fix

Upgrade to a newer version if available, or stay on Vite 2

affects: <=1.1.0

deprecatedpug-lint itself is no longer actively maintained; consider using pug-lexer and custom scripts

fix

Evaluate alternatives like eslint-plugin-vue-pug

affects: >=2.6.0

gotchaThe plugin only lints .vue files; it ignores .pug standalone files

fix

Use include option to add extra patterns: /\.pug$/

affects: >=1.0.0

gotchaPlugin must be placed before @vitejs/plugin-vue in plugins array

fix

Ensure pugLint() is called before vue()

affects: >=1.0.0

Errors

Common errors & fixes

Cannot find module 'pug-lint'

pug-lint not installed as devDependency

fix

npm install pug-lint --save-dev

TypeError: pugLint is not a function

Importing the plugin incorrectly, using named export as default

fix

Use default import: import pugLint from 'vite-plugin-vue-pug-lint'

Error: The configuration file was not found at path/to/.pug-lintrc

Specified configFile path does not exist

fix

Check the path or remove configFile option to use default lookup

Upgrade

Version history

1.1.0latest on npm

Audit

Dependencies

viteoptionalpeer dependency, required for plugin to work

pug-lintoptionalpeer dependency, provides the linting engine

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/brzezinskimarcin/vite-plugin-vue-pug-lint ↗

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