---
name: node-gyp
summary: "node-gyp is the cross-platform command-line tool that compiles native add-on modules for Node.js, wrapping a vendored copy of Google's gyp build-configuration generator to drive the local C/C++ toolchain. It is invoked automatically by npm whenever a package contains native code that must be built from source."
language: Python
license: MIT
repo: https://github.com/nodejs/node-gyp
source: https://opensources.dev/resource/node-gyp
health: 100
---

# node-gyp

node-gyp is the cross-platform command-line tool that compiles native add-on modules for Node.js, wrapping a vendored copy of Google's gyp build-configuration generator to drive the local C/C++ toolchain. It is invoked automatically by npm whenever a package contains native code that must be built from source.

## Versions of `node-gyp` that are earlier than v11.x.x

Please look thru your error log for the string `gyp info using node-gyp@` and if that version number is less than the [current release of node-gyp](https://github.com/nodejs/node-gyp/releases) then **please upgrade** using [these instructions](https://github.com/nodejs/node-gyp/blob/main/docs/Updating-npm-bundled-node-gyp.md) and then try your command again.

## `node-sass` is deprecated

Please be aware that the package [`node-sass` is deprecated](https://github.com/sass/node-sass#node-sass) so you should actively seek alternatives.  You can try:

```tsx
npm uninstall node-sass
npm install sass --save
# or ...
npm install --global node-sass@latest
```

`node-sass` projects *may* work by downgrading to Node.js v14 but [that release is end-of-life](https://github.com/nodejs/release#release-schedule).

In any case, please avoid opening new `node-sass` issues on this repo because we [cannot help much](https://github.com/nodejs/node-gyp/issues?q=is%3Aissue+label%3A%22Node+Sass+--%3E+Dart+Sass%22).

## `ffi-napi` is no longer maintained

- node-ffi-napi/node-ffi-napi#269

There are a couple of workarounds ([https://koffi.dev](https://koffi.dev) or `node-ffi-rs`) on that issue but using `ffi-napi` or its forks has proven problematic on modern versions of operating systems, Node.js, node-gyp, and Python.

In any case, please avoid opening new `ffi-napi` issues on this repo because we [cannot help much](https://github.com/nodejs/node-gyp/issues?q=label%3Affi-napi).