Dev Doctor

Dev Doctor is a VS Code extension that helps you keep your projects healthy and your code clean – all in one place.

Features

🩺 Project Health Check

Run a single command and Dev Doctor will inspect your workspace for common issues:

• Checks for important project files:
  • package.json
  • .git
  • tsconfig.json
• Ensures heavy folders are excluded for better performance:
  • node_modules
  • dist
  • build
  • out
• Detects ESLint / Prettier usage:
  • Warns if ESLint is present but Prettier is missing
  • Detects when Prettier is installed but no config exists
  • Can generate a basic .prettierrc
• TypeScript “doctor”:
  • Warns if paths are defined without baseUrl
  • Checks that baseUrl folder exists
  • Detects workspace TypeScript (node_modules/typescript) and can configure VS Code to use it
• Debug configuration:
  • Creates a basic .vscode/launch.json for Node.js if missing
• Git root awareness:
  • Warns if the opened folder is not the actual Git root
  • Can reopen the real repo root as the workspace

✨ Built-in Formatting (Prettier inside Dev Doctor)

Dev Doctor includes its own Prettier-based formatter, so you don’t need to install a separate Prettier extension.

• Formats:
  • JavaScript / TypeScript
  • JSX / TSX
  • JSON / JSONC
  • HTML
  • CSS / SCSS / Less
• Respects your .prettierrc or prettier.config.* if present
• Uses your editor tab size / spaces settings

You can use it via:

• Format Document (Shift+Alt+F / Shift+Option+F)
• Or set Dev Doctor as default formatter in your VS Code settings.

🧹 Format Entire Workspace

Dev Doctor can format an entire project in one go:

• Command: Dev Doctor: Format Entire Workspace
• Formats all *.js, *.jsx, *.ts, *.tsx, *.json, *.jsonc, *.html, *.css, *.scss, *.less files
• Skips node_modules and other generated folders

⏪ Undo Last Config Fix

Worried about automatic changes? Dev Doctor keeps backups of key config files when you click Fix Automatically:

Backed up files:

• .vscode/settings.json
• .prettierrc
• .vscode/launch.json

You can restore them with:

• Dev Doctor: Undo Last Config Fix

This restores the previous versions (or deletes files that Dev Doctor created) using .devdoctor.bak backups.

Commands

How to Use

1. Open a folder in VS Code.
2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
3. Run Dev Doctor: Run Project Health Check.
4. Review the list of issues and click Fix Automatically if you’re happy with the suggested changes.
5. Use Format Document or Dev Doctor: Format Entire Workspace to clean up your code.
6. If you don’t like the config changes, run Dev Doctor: Undo Last Config Fix to restore the previous versions.

Requirements

• VS Code ^1.106.0 or later
• Node.js (for development / building the extension)

Development

# install dependencies
npm install

# compile once
npm run compile

# or run in watch mode
npm run watch

# launch extension in VS Code
# press F5 in VS Code to start the Extension Development Host