feat(pages): add N-API pages

[avivkeller]

cc @nodejs/node-api

I've re-written these files from https://github.com/nodejs/node-addon-examples/tree/main/website/docs. Please note that these files are not identical to the previous versions. I've made some minor adjustments, including, but not limited to:

1. Moving duplicate content to it's own file, pages/napi/getting-started/project-structure.md, and adding index.md pages
2. Removing references to deprecated or outdated tooling, such as Yeoman.
3. Fixing outdated information, such as the Python version needed for node-gyp.
4. Minor prose changes, such as typo fixes or grammatical improvements.

The authors of these files are currently marked as @gabrielschulhof, @NickNaso, @jschlight, @mhdawson, @KevinEady, and myself, @avivkeller.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nodejs-learn	Ready	Preview	Apr 25, 2026 8:53pm

[Copilot]

Pull request overview

Adds a new Node-API (N-API) documentation section to the Learn site, including sidebar navigation and a set of rewritten guides ported from node-addon-examples.

Changes:

• Add a new “Node-API” group to site.json sidebar navigation.
• Add new Node-API docs pages (overview, getting started, build tools, special topics).
• Update Sidebar pathname handling to better support index.md-based routes.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 32 comments.

Show a summary per file

File	Description
site.json	Adds “Node-API” section + links to the Learn sidebar
components/Sidebar/index.jsx	Adjusts pathname handling to strip /index
pages/napi/index.md	Introduces Node-API landing page content
pages/napi/getting-started/index.md	Adds Getting Started index page
pages/napi/getting-started/prerequisites.md	Adds prerequisites content
pages/napi/getting-started/tools.md	Adds tooling/setup guidance
pages/napi/getting-started/project-structure.md	Adds shared project structure reference
pages/napi/getting-started/your-first-project.md	Adds first-project tutorial
pages/napi/getting-started/objectwrap.md	Adds ObjectWrap tutorial
pages/napi/getting-started/migration.md	Adds NAN → Node-API migration tutorial
pages/napi/build-tools/index.md	Adds build-tools index page
pages/napi/build-tools/node-gyp.md	Adds node-gyp guide
pages/napi/build-tools/cmake-js.md	Adds CMake.js guide
pages/napi/build-tools/node-pre-gyp.md	Adds node-pre-gyp guide
pages/napi/build-tools/prebuild.md	Adds prebuild guide
pages/napi/special-topics/index.md	Adds special-topics index page
pages/napi/special-topics/asyncworker.md	Adds AsyncWorker guide
pages/napi/special-topics/object-function-refs.md	Adds references guide
pages/napi/special-topics/thread-safe-functions.md	Adds thread-safe functions guide
pages/napi/special-topics/context-awareness.md	Adds context-awareness guide + examples

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[avivkeller]

Bump @nodejs/node-api @nodejs/nodejs-website

[cursor]

PR Summary

Medium Risk
Mostly adds new documentation pages, but also changes sidebar pathname normalization and updates site.json navigation, which could affect routing/active-link behavior across the Learn sidebar.

Overview
Adds a new Node-API documentation section under pages/node-api/, including landing pages plus guides for getting started, build tools (node-gyp, CMake.js, node-pre-gyp), and special topics (e.g. AsyncWorker, thread-safe functions, context awareness).

Updates site.json to surface this new section in the Learn sidebar, and tweaks components/Sidebar to strip /index from metadata.path when computing the current pathname for active navigation highlighting.

^{Reviewed by Cursor Bugbot for commit 8dafbc7. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vmoroz]

We want to avoid the term 'napi' to use in future. Is it possible to name the folder 'node-api'?
Adding @legendecas who is currently driving the Node-API effort,

[gengjiawen]

good work

[legendecas]

We want to avoid the term 'napi' to use in future. Is it possible to name the folder 'node-api'?

I think we should prefer node-api or n-api (as in https://nodejs.org/docs/latest/api/n-api.html) for consistency. napi should be avoided if possible.

[avivkeller]

@vmoroz @legendecas Better?