#630·takenote

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-sass requires 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

  1. Clone the repo: git clone https://github.com/taniarascia/takenote.git
  2. Use Node 18 or 20+ (current LTS or latest)
  3. Run npm install
  4. Installation fails during node-sass install

Proposed Fixes

Option 1: Replace node-sass with sass

This can be done by updating package.json:

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!