Installation fails on Node 20+ due to node-sass and node-gyp issues
Author: Dipanshu-KubdeCreated Jul 7, 2025Updated Jul 7, 2025
LabelsType: Bug
Problem
Installing dependencies on modern Node.js versions (e.g., v20.11.0) fails due to the use of [email protected], which is now deprecated and incompatible with newer Node versions.
Running npm install throws the following error:
npm ERR! [email protected] install: node scripts/build.js npm ERR! Failed at the [email protected] install script
This happens because:
node-sassrequires an older Node version- It relies on native builds via
node-gyp, which has Python version conflicts - Many users may not know they need to downgrade or patch it
Steps to Reproduce
- Clone the repo:
git clone https://github.com/taniarascia/takenote.git - Use Node 18 or 20+ (current LTS or latest)
- Run
npm install - Installation fails during
node-sassinstall
Proposed Fixes
Option 1: Replace node-sass with sass
This can be done by updating package.json:
"node-sass": "4.14.1"
⬇️
"sass": "^1.69.0"
Then run:
npm uninstall node-sass
npm install sass
This change is backward-compatible and resolves install issues across platforms.
Option 2: Add Node version requirement
If switching to sass isn’t possible, please consider:
Adding a .nvmrc file (e.g., 14.21.3)
Updating the README to mention the required Node version
Final Note
This is a great project for learning React, but many beginners might hit this issue and give up. Updating the setup instructions or patching the dependency will make onboarding much easier for the community.
Thanks for your awesome work and maintenance!Source: taniarascia/takenote