Upgrade minimum node version to 22 (#10305)

timotheeguerin · web-flow · commit 2a3cc5e3e602 · 2026-04-09T19:07:11.000Z
Node 20 EOL is at the end april, which means next Typespec release will
drop support.
We already have plenty of our dependencies that have dropped early and
upgrading will allow us to use some nice built-in
diff --git a/.chronus/changes/node-22-min-2026-3-8-12-27-17.md b/.chronus/changes/node-22-min-2026-3-8-12-27-17.md
@@ -0,0 +1,34 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: internal
+packages:
+  - "@typespec/asset-emitter"
+  - "@typespec/bundler"
+  - "@typespec/compiler"
+  - "@typespec/eslint-plugin"
+  - "@typespec/events"
+  - "@typespec/html-program-viewer"
+  - "@typespec/http-server-csharp"
+  - "@typespec/http-specs"
+  - "@typespec/http"
+  - "@typespec/internal-build-utils"
+  - "@typespec/json-schema"
+  - "@typespec/library-linter"
+  - "@typespec/openapi"
+  - "@typespec/openapi3"
+  - "@typespec/playground"
+  - "@typespec/rest"
+  - "@typespec/spec-api"
+  - "@typespec/spec-coverage-sdk"
+  - "@typespec/spector"
+  - "@typespec/sse"
+  - "@typespec/streams"
+  - tmlanguage-generator
+  - "@typespec/tspd"
+  - typespec-vs
+  - typespec-vscode
+  - "@typespec/versioning"
+  - "@typespec/xml"
+---
+
+Upgrade minimum node version to 22
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -11,7 +11,7 @@ TypeSpec is a language for defining cloud service APIs and shapes. This monorepo
 
 ### Prerequisites and Installation
 
-- Install Node.js 20 LTS: `curl -fsSL https://nodejs.org/dist/v20.19.4/node-v20.19.4-linux-x64.tar.xz | tar -xJ --strip-components=1 -C /usr/local`
+- Install Node.js LTS:
 - Install pnpm globally: `npm install -g pnpm`
 - Install dependencies: `pnpm install` (takes ~1.5 minutes)
 - Install Playwright browsers (optional for UI testing): `npx playwright install`
diff --git a/.github/workflows/core-ci.yml b/.github/workflows/core-ci.yml
@@ -15,7 +15,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
-        node-version: ["20.x", "22.x", "24.x"]
+        node-version: ["22.x", "24.x"]
 
     env:
       TYPESPEC_VS_CI_BUILD: true
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -4,7 +4,7 @@ This section goes over the setup of the repo for development.
 
 ## Repo setup
 
-- Install [Node.js](https://nodejs.org/) 20 LTS
+- Install [Node.js](https://nodejs.org/) 24 LTS
 - Install [pnpm](https://pnpm.io/)
 
 ```bash
diff --git a/docker/Dockerfile b/docker/Dockerfile
@@ -2,9 +2,7 @@
 #  Build compiler
 # --------------------------------
 # cspell:ignore tdnf
-# mcr doesn't provide any update to date images for nodejs... so we use the devcontainers image for building.
-# FROM mcr.microsoft.com/azurelinux/base/nodejs:20.14 AS builder
-FROM mcr.microsoft.com/devcontainers/javascript-node:22 AS builder
+FROM mcr.microsoft.com/devcontainers/javascript-node:24 AS builder
 COPY . /app
 
 # Upgrade all packages per https://eng.ms/docs/more/containers-secure-supply-chain/updating.
@@ -24,7 +22,7 @@ RUN pnpm pack
 # --------------------------------
 #  Setup final image
 # --------------------------------
-FROM mcr.microsoft.com/azurelinux/base/nodejs:20.14
+FROM mcr.microsoft.com/azurelinux/base/nodejs:24
 
 COPY --from=builder /app/packages/compiler/*.tgz /tmp/compiler.tgz
 
diff --git a/eng/tsp-core/pipelines/stages/ci-stages.yml b/eng/tsp-core/pipelines/stages/ci-stages.yml
@@ -15,8 +15,6 @@ stages:
 
         strategy:
           matrix:
-            "Node 20.x":
-              nodeVersion: 20.x
             "Node 22.x":
               nodeVersion: 22.x
             "Node 24.x":
@@ -42,8 +40,6 @@ stages:
 
         strategy:
           matrix:
-            "Node 20.x":
-              nodeVersion: 20.x
             "Node 22.x":
               nodeVersion: 22.x
             "Node 24.x":
diff --git a/packages/asset-emitter/package.json b/packages/asset-emitter/package.json
@@ -23,7 +23,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/best-practices/package.json b/packages/best-practices/package.json
@@ -23,7 +23,7 @@
     ".": "./dist/src/index.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/bundle-uploader/package.json b/packages/bundle-uploader/package.json
@@ -20,7 +20,7 @@
   "type": "module",
   "main": "dist/src/index.js",
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/bundler/package.json b/packages/bundler/package.json
@@ -23,7 +23,7 @@
     "./vite": "./dist/src/vite/index.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "bundle": "node ./dist/src/cli.js",
diff --git a/packages/compiler/package.json b/packages/compiler/package.json
@@ -69,7 +69,7 @@
     "./dist/src/core/logger/console-sink.js": "./dist/src/core/logger/console-sink.browser.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "bin": {
     "tsp": "cmd/tsp.js",
diff --git a/packages/eslint-plugin-typespec/package.json b/packages/eslint-plugin-typespec/package.json
@@ -19,7 +19,7 @@
   "type": "commonjs",
   "main": "dist/src/index.js",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/events/package.json b/packages/events/package.json
@@ -31,7 +31,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/html-program-viewer/package.json b/packages/html-program-viewer/package.json
@@ -29,7 +29,7 @@
     "./style.css": "./dist/style.css"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/http-server-csharp/package.json b/packages/http-server-csharp/package.json
@@ -34,7 +34,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/http-specs/package.json b/packages/http-specs/package.json
@@ -27,7 +27,7 @@
     "test": "echo \"Error: no test specified\""
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
diff --git a/packages/http/package.json b/packages/http/package.json
@@ -51,7 +51,7 @@
     "#test/*": "./test/*"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/internal-build-utils/package.json b/packages/internal-build-utils/package.json
@@ -22,7 +22,7 @@
     "typespec-build-tool": "cmd/cli.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/json-schema/package.json b/packages/json-schema/package.json
@@ -32,7 +32,7 @@
   },
   "tspMain": "lib/main.tsp",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/library-linter/package.json b/packages/library-linter/package.json
@@ -31,7 +31,7 @@
   },
   "tspMain": "dist/src/index.js",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/monarch/package.json b/packages/monarch/package.json
@@ -23,7 +23,7 @@
     ".": "./dist/src/index.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/openapi/package.json b/packages/openapi/package.json
@@ -31,7 +31,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/openapi3/package.json b/packages/openapi3/package.json
@@ -37,7 +37,7 @@
     "#test/*": "./test/*"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/pack/package.json b/packages/pack/package.json
@@ -26,7 +26,7 @@
     "tsp-pack": "cmd/cli.js"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "bundle": "node ./dist/src/cli.js",
diff --git a/packages/playground-website/package.json b/packages/playground-website/package.json
@@ -30,7 +30,7 @@
     "./style.css": "./dist/lib/style.css"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./dist-dev ./temp ./samples/dist",
diff --git a/packages/playground/package.json b/packages/playground/package.json
@@ -51,7 +51,7 @@
     "./styles.css": "./dist/style.css"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./dist-dev ./temp ./typespecContents.json",
diff --git a/packages/react-components/package.json b/packages/react-components/package.json
@@ -27,7 +27,7 @@
     "./style.css": "./dist/style.css"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/rest/package.json b/packages/rest/package.json
@@ -31,7 +31,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/samples/package.json b/packages/samples/package.json
@@ -26,7 +26,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/spec-api/package.json b/packages/spec-api/package.json
@@ -15,7 +15,7 @@
     "test": "vitest run"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
diff --git a/packages/spec-coverage-sdk/package.json b/packages/spec-coverage-sdk/package.json
@@ -10,7 +10,7 @@
     "clean": "rimraf dist/ temp/"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
diff --git a/packages/spec-dashboard/package.json b/packages/spec-dashboard/package.json
@@ -23,7 +23,7 @@
     "./style.css": "./dist/style.css"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
diff --git a/packages/spector/package.json b/packages/spector/package.json
@@ -22,7 +22,7 @@
     "test:ui": "vitest --ui"
   },
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "repository": {
     "type": "git",
diff --git a/packages/sse/package.json b/packages/sse/package.json
@@ -27,7 +27,7 @@
     "./testing": "./dist/src/testing/index.js"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/standalone/README.md b/packages/standalone/README.md
@@ -2,6 +2,6 @@
 
 This package contains the logic for building and bundling the TypeSpec CLI as a standalone executable.
 
-It requires node 20+ to use node single executable. https://nodejs.org/api/single-executable-applications.html
+It requires node 22+ to use node single executable. https://nodejs.org/api/single-executable-applications.html
 
 It is also possible to build with bun (code is there) but there is some issue due to signing. Goal will be to migrate to bun when those are resolved.
diff --git a/packages/standalone/package.json b/packages/standalone/package.json
@@ -19,7 +19,7 @@
   ],
   "type": "module",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/standalone/scripts/build.ts b/packages/standalone/scripts/build.ts
@@ -8,8 +8,8 @@ import { writeSeaConfig } from "./sea-config.js";
 // cspell:ignore postject
 
 const [major, minor, patch] = process.versions.node.split(".").map(Number);
-if (major < 20) {
-  console.error("Cannot build standalone cli on node under 20");
+if (major < 22) {
+  console.error("Cannot build standalone cli on node under 22");
   process.exit(0);
 }
 
diff --git a/packages/streams/package.json b/packages/streams/package.json
@@ -31,7 +31,7 @@
     }
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/tmlanguage-generator/package.json b/packages/tmlanguage-generator/package.json
@@ -19,7 +19,7 @@
   ],
   "main": "dist/tmlanguage-generator.js",
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "clean": "rimraf ./dist ./temp",
diff --git a/packages/tsp-integration/package.json b/packages/tsp-integration/package.json
diff --git a/packages/tspd/package.json b/packages/tspd/package.json
diff --git a/packages/typespec-vs/package.json b/packages/typespec-vs/package.json
diff --git a/packages/typespec-vscode/src/typespec-utils.ts b/packages/typespec-vscode/src/typespec-utils.ts
diff --git a/packages/versioning/package.json b/packages/versioning/package.json
diff --git a/packages/xml/package.json b/packages/xml/package.json
diff --git a/website/src/content/docs/docs/extending-typespec/basics.md b/website/src/content/docs/docs/extending-typespec/basics.md
diff --git a/website/src/content/docs/docs/getting-started/getting-started-rest/01-setup-basic-syntax.mdx b/website/src/content/docs/docs/getting-started/getting-started-rest/01-setup-basic-syntax.mdx

Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@`
`23`	`23`	`}`
`24`	`24`	`},`
`25`	`25`	`"engines": {`
`26`		`- "node": ">=20.0.0"`
	`26`	`+ "node": ">=22.0.0"`
`27`	`27`	`},`
`28`	`28`	`"scripts": {`
`29`	`29`	`"clean": "rimraf ./dist ./temp",`