🩺 Project Doctor

Project Doctor is a zero-config CLI tool that diagnoses common problems in Node.js projects with a single command.

Think of it as a health checkup for your project — before bugs appear, before CI fails, and before deployment breaks.

✨ Why Project Doctor?

As Node.js projects grow, small configuration and dependency issues can silently pile up and cause serious problems later.

Common issues include:

• Missing or inconsistent lockfiles
• Unused or forgotten dependencies
• Incomplete package.json configuration
• Unused or forgotten .env variables
• Undefined or unclear Node.js version requirements

Project Doctor scans your project instantly and reports these problems in a clean, readable format — with no configuration required.

🚀 Features

✔ Validate required Node.js version (engines.node)
✔ Detect missing lockfiles (npm, yarn, pnpm)
✔ Check required package.json fields
✔ Detect unused dependencies
✔ Detect unused environment variables
✔ Detect unused variables and functions (with line numbers)
✔ Automatically format project files for better readability
✔ Color-coded, readable CLI output
✔ Works with any Node.js project
✔ Zero setup — just run the command

📦 Installation

You do not need to install Project Doctor globally.

Run instantly using npx

npx project-doctor