About vue-doctor
Vue Doctor scans Vue and Nuxt codebases for security, performance, correctness, and architecture issues. It gives developers actionable diagnostics with file locations and a score from 0 to 100.
Key features
- 01Checks 30+ rules across code quality areas
- 02Finds security risks and correctness issues
- 03Flags performance and bundle-size concerns
- 04Detects architecture and accessibility problems
- 05Reports file paths, line numbers, and a score
Use cases
- 01Review a Vue or Nuxt project for issues
- 02Prioritize fixes by diagnostic severity
- 03Rerun scans to check whether the score improves
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ arjun-ingole/ vue-doctor --skill vue-doctorAfter installing, type/vue-doctorin Claude Code to confirm it loaded.
Details
From the project READMEVue Doctor
Scans your Vue/Nuxt codebase for security, performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
Usage
npx -y vue-doctor@latest . --verbose
Workflow
- Run the command above at the project root
- Read every diagnostic with file paths and line numbers
- Fix issues starting with errors (highest severity)
- Re-run to verify the score improved
Rules (30+)
- Security: v-html XSS risks, eval(), hardcoded secrets in client code
- Composition API: watch as computed, async watchEffect, reactive destructuring, ref in computed
- Performance: index as key, deep watch, expensive template expressions, method calls in v-for
- Architecture: prop mutation, missing emits declaration, giant components
- Correctness: v-if with v-for, this in setup, direct DOM manipulation, missing prop types
- Nuxt: window in SSR, missing SEO meta, process.env in client, server route error handling
- Bundle Size: barrel imports, full lodash, moment.js, heavy libraries
- Accessibility: missing prefers-reduced-motion for motion libraries
- Dead Code: unused files, exports, types
Score
- 75+: Great
- 50-74: Needs work
- 0-49: Critical
Comments
Markdown supported