Cannot find module 'node-sass' error

avatar

Borislav Hadzhiev

Last updated: Jul 25, 2022

banner

Photo from Unsplash

Cannot find module 'node-sass' error #

To solve the error "Cannot find module 'node-sass'", make sure to install the node-sass package by opening your terminal in your project's root directory and running the following command: npm i -D node-sass and restart your IDE and development server.

cannot find module node sass

Open your terminal in your project's root directory (where your package.json file is located) and run the following command:

shell
npm install --save-dev node-sass # 👇️ only if you use TypeScript npm install --save-dev @types/node-sass

This will add the node-sass package to the development dependencies of your project.

If you still get the error, try to install the package with the --unsafe-perm flag.

shell
npm install --save-dev --unsafe-perm node-sass

If the command above fails with a permissions error, try prefixing it with sudo.

shell
sudo npm install --save-dev --unsafe-perm node-sass

The --unsafe-perm flag forces npm to download the node-sass binary to your project.

If the error is not resolved, try to delete your node_modules and package-lock.json (not package.json) files, re-run npm install and restart your IDE.

shell
# 👇️ delete node_modules and package-lock.json rm -rf node_modules rm -f package-lock.json # 👇️ clean npm cache npm cache clean --force npm install
Make sure to restart your IDE and dev server if the error persists. VSCode often glitches and a reboot solves things sometimes.

If you still get the error, open the npm page of node-sass and look at the Node version support policy.

NodeJSSupported node-sass version
Node 177.0+
Node 166.0+
Node 155.0+
Node 144.14+
Node 134.13+, <5.0
You have to make sure that you are installing a compatible node-sass version based on your Node.js version.

You can view your Node.js version with the following command:

shell
node -v

get node version

Based on the output in the screenshot above, I have to install a node-sass version greater than 7.0.

You can install a specific version of the package by using the @ symbol, e.g. npm install --save-dev node-sass@7.0.1.

If you still get the "Cannot find module 'node-sass'" error, open your package.json file and make sure it contains the node-sass package in the devDependencies object.

package.json
{ // ... rest "devDependencies": { "node-sass": "^7.0.1", // 👇️ only if you use TypeScript "@types/node-sass": "^4.11.2", } }

You can try to manually add the line and re-run npm install.

shell
npm install

Or install the latest version of the package:

shell
npm install --save-dev node-sass@latest

The node-sass module should NOT be globally installed or be in your project's dependencies. It should be in the devDependencies object in your package.json file.

Conclusion #

To solve the error "Cannot find module 'node-sass'", make sure to install the node-sass package by opening your terminal in your project's root directory and running the following command: npm i -D node-sass and restart your IDE and development server.

I wrote a book in which I share everything I know about how to become a better, more efficient programmer.
book cover
You can use the search field on my Home Page to filter through all of my articles.