# microsoft/nodejs-guidelines

Tips, tricks, and resources for working with Node.js, and the start of an ongoing conversation on how we can improve the Node.js experience on Microsoft platforms.

Repository: https://github.com/microsoft/nodejs-guidelines
Canonical: https://ross.abutalabs.com/products/nodejs-guidelines
License Family: other
Archived: true
Last push: 2023-02-12T09:16:18+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3958, "days_push": 1298, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2496, forks 277 (observed 2026-08-28T04:06:56.690468+00:00)

## What it is
A Microsoft-maintained collection of tips, tricks, and resources for working with Node.js, especially on Microsoft platforms like Windows and Azure. It consolidates guidance on getting started, npm packages, Windows environment setup, cross-platform building, and deployment.

## Use cases
- set up a Node.js development environment on Windows
- learn how to manage npm packages and dependencies
- deploy a Node.js app to Azure
- avoid Windows-specific gotchas like MAX_PATH issues
- build cross-platform Node.js applications
- find Microsoft tools and services for Node.js development

## When to choose
- you are developing Node.js on Windows or with Microsoft/Azure services
- you want curated getting-started guidance and tooling recommendations
- you need tips on cross-platform compatibility and deployment

## When to avoid
- you need executable code, libraries, or tooling rather than documentation
- you want comprehensive, up-to-date Node.js tutorials independent of Microsoft platforms
- you need actively evolving content - the repo is largely static guidance

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: documentation, developer-tools
- domain: developer-tools, web-development, tutorials, windows
- platform: windows, cross-platform
- tags: nodejs, microsoft, guidelines, best-practices, azure, getting-started

## Member repositories
- microsoft/nodejs-guidelines (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:56.690468+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:27:12.045338+00:00, confidence not recorded.
  - readme: https://github.com/microsoft/nodejs-guidelines (fetched 2026-08-28T04:06:56.690468+00:00, sha d40eff0a0ff3)
- Data as of 2026-08-30T08:39:29.467469+00:00.
