Cannot find module 'node-sass' error [Solved]

avatar
Borislav Hadzhiev

Last updated: Mar 6, 2024
2 min

banner

# 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

install node sass package

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

install node sass with unsafe perm flag

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.

# Delete your node_modules and reinstall your dependencies

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.

If you are on macOS or Linux, issue the following commands in bash or zsh.

shell
# for macOS and Linux rm -rf node_modules rm -f package-lock.json rm -f yarn.lock # ๐Ÿ‘‡๏ธ clean npm cache npm cache clean --force # ๐Ÿ‘‡๏ธ install packages npm install

If you are on Windows, issue the following commands in CMD.

cmd
# for Windows rd /s /q "node_modules" del package-lock.json del -f yarn.lock # ๐Ÿ‘‡๏ธ clean npm cache npm cache clean --force # ๐Ÿ‘‡๏ธ install packages npm install
Make sure to restart your IDE and dev server if the error persists. VSCode often glitches and a reboot solves things sometimes.

# Verify your Node.js version matches your node-sass version

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

NodeJS versionSupported node-sass version
Node 198.0+
Node 188.0+
Node 177.0+, <8.0
Node 166.0+
Node 155.0+, <7.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.

# Verify you have node-sass installed

If you still get the 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

install node sass package latest version

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.

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.

Copyright ยฉ 2024 Borislav Hadzhiev