nodejs / nodejs/node-gyp

Instructions to update bundled node-gyp do not work on Windows + npm >= 10

Open
#3,172 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Documentation
Dominant language
Python
Stars
10.7k
Forks
1.9k
Avg merge
1d 4h
Merged PRs (30d)
5

Description

https://github.com/nodejs/node-gyp/blob/main/docs/Updating-npm-bundled-node-gyp.md#windows

These instructions fail for me using node v20.18.2 and npm 10.8.2.

I see similar reports on stackoverflow etc.

npm error code E404
npm error 404 Not Found - GET https://registry.npmjs.org/@npmcli%2fdocs - Not found
npm error 404
npm error 404  '@npmcli/docs@^1.0.0' is not in this registry.
npm error 404
npm error 404 Note that you can also install from a
npm error 404 tarball, folder, http url, or git url.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Windows section of docs/Updating-npm-bundled-node-gyp.md and reproduce the reported steps using Node v20.18.2 with npm 10.8.2. Trace the resulting @npmcli/docs E404 and update the instructions so the documented process works on Windows with npm 10 or later; verify the revised steps no longer request that missing package.

Written by the indexing model from the issue text.

Assessment

Tech stack
nodejs
Domain
documentation, tooling
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.