Commands
Diagnose common project health problems and apply safe, explained fixes.
broom doctorbroom doctor --verbosebroom doctor --jsonbroom doctor --fix [--yes] broom doctor Project fixture-next-app 1.0.0 Framework Next.js 15.1.0 Package manager unknown Node.js 24.22.1 TypeScript yes Git main ! Lockfiles No lockfile found; installs are not reproducible ! Installed node_modules not found; run "npm install" ✗ Imported packages 1 imported package(s) not declared in package.json axios — app/page.tsx ! Duplicate declarations 1 package(s) in both dependencies and devDependencies · npm scripts No "test" script ✗ .gitignore Environment file(s) not ignored by git: .env fix: Append node_modules/, .env and .env*.local to .gitignore (--fix) · Git on main, clean ! Environment variables 2 referenced but not defined (API_URL, SECRET_TOKEN) ✓ 4 checks passed (--verbose to list) 2 failed, 4 warnings, 4 passedpackage.json validityengines.nodepackageManagernode_modules.gitignore: exists, ignores node_modules, ignores env filesnext.config.ts on Next < 15, eslint-config-next/@next/* version alignment, router directoriesindex.html, React plugin without React--fix offers only these safe fixes, each listed and confirmed first:
.gitignore.gitignore.env.example| Flag | Description |
|---|---|
--fix | Apply safe, explained fixes. Asks first. |
-y, --yes | With --fix: apply all available fixes without prompting. |
Found a problem in these docs? Open an issue on GitHub.