From fa664426b4af81db817d08ed59558db192dd0df1 Mon Sep 17 00:00:00 2001
From: Shinyaigeek <philispaxil@gmail.com>
Date: Sun, 28 Jun 2026 23:42:23 +0900
Subject: [PATCH] chore: pin Node.js to v24 (LTS)

Standardize the toolchain on Node.js 24.18.0 (current LTS, "Krypton"):

- Add a `.node-version` file so local tooling (nvm/fnm/mise/Volta) and CI
  resolve the same Node version.
- Have both GitHub Actions workflows read the version from `.node-version`
  via `node-version-file` instead of a hardcoded `node-version: 20`, keeping
  a single source of truth.
- Declare the requirement in package.json `engines.node` (exact match to
  `.node-version`).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .github/workflows/build-js.yml            | 2 +-
 .github/workflows/publish-npm-package.yml | 2 +-
 .node-version                             | 1 +
 package.json                              | 3 +++
 4 files changed, 6 insertions(+), 2 deletions(-)
 create mode 100644 .node-version

diff --git a/.github/workflows/build-js.yml b/.github/workflows/build-js.yml
index c69e5db80..77598517c 100644
--- a/.github/workflows/build-js.yml
+++ b/.github/workflows/build-js.yml
@@ -18,7 +18,7 @@ jobs:
           version: 9.0.6
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: '.node-version'
           cache: pnpm
           cache-dependency-path: 'pnpm-lock.yaml'
 
diff --git a/.github/workflows/publish-npm-package.yml b/.github/workflows/publish-npm-package.yml
index 2ee8ba613..684b8b0c9 100644
--- a/.github/workflows/publish-npm-package.yml
+++ b/.github/workflows/publish-npm-package.yml
@@ -34,7 +34,7 @@ jobs:
           version: 9.15.4
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: ".node-version"
           registry-url: "https://registry.npmjs.org"
           cache: pnpm
           cache-dependency-path: "**/pnpm-lock.yaml"
diff --git a/.node-version b/.node-version
new file mode 100644
index 000000000..ca5c35005
--- /dev/null
+++ b/.node-version
@@ -0,0 +1 @@
+24.18.0
diff --git a/package.json b/package.json
index f9231c4ca..4e4de6155 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,9 @@
 {
   "name": "OpenUI",
   "version": "1.0.0",
+  "engines": {
+    "node": "24.18.0"
+  },
   "description": "The open standard for generative UI — a streaming-first language, React runtime, and component libraries for building AI-powered chat and copilot interfaces",
   "main": "index.js",
   "scripts": {