# nodejs/node-addon-examples

Node.js C++ addon examples from http://nodejs.org/docs/latest/api/addons.html

Repository: https://github.com/nodejs/node-addon-examples
Canonical: https://ross.abutalabs.com/products/node-addon-examples
Language: C++
License: NOASSERTION
License Family: other
Topics: nodejs, node
Last push: 2026-07-13T04:10:33+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 92, release rhythm 35, longevity 100
- inputs: {"age_days": 4970, "days_push": 51, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2589, forks 602 (observed 2026-08-28T04:07:02.864595+00:00)

## What it is
A repository of example Node.js C++ addons demonstrating the Node-API, node-addon-api, and nan APIs. It serves as the official reference examples accompanying the Node.js addons documentation.

## Use cases
- learn how to write Node.js C++ addons
- examples of Node-API usage
- how to use node-addon-api wrapper classes
- convert JavaScript values to native C++ types in a Node addon
- run async work in a Node.js native addon
- thread-safe functions in Node addons
- build context-aware Node.js addons

## When to choose
- you are learning to write native C++ addons for Node.js
- you need reference implementations of Node-API or node-addon-api patterns
- you want up-to-date examples maintained alongside Node.js docs

## When to avoid
- you need a production-ready addon library rather than examples
- you want bindings for a specific native library
- you need examples for unsupported legacy Node.js versions to be maintained

## Facets
- artifact type: learning-resource
- maturity: active
- function: developer-tools, sdk
- domain: developer-tools, tutorials, programming-languages
- platform: cpp, cross-platform
- tags: nodejs-addons, node-api, napi, cpp-bindings, examples, native-addons, nodejs

## Member repositories
- nodejs/node-addon-examples (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:02.864595+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:22:22.339303+00:00, confidence not recorded.
  - readme: https://github.com/nodejs/node-addon-examples (fetched 2026-08-28T04:07:02.864595+00:00, sha 8e753196252c)
- Data as of 2026-08-30T08:39:29.467469+00:00.
