Instruction file imported from n8io/quick-release (
.cursor/rules/terminal-commands/troubleshooting.mdc). Copyright stays with the author.
Troubleshooting Common Issues
Description
This rule provides a structured approach to troubleshooting common issues with npm and Node.js in the project.
Why
Having a systematic approach to troubleshooting helps resolve issues quickly and maintains project stability.
How
-
Clear npm cache when experiencing package-related issues:
npm cache clean --force -
Reset node_modules when experiencing dependency issues:
rm -rf node_modules nvm install npm install -
Follow the troubleshooting steps in order:
- Start with cache clearing
- If issues persist, proceed with node_modules reset
- Ensure correct Node.js version is installed
Example
# Complete troubleshooting process
npm cache clean --force
rm -rf node_modules
nvm install
npm install
Related
- npm cache
- Dependency management
- Node.js version management
- Project maintenance