From 234766e3c8b71c8ac8dcfe6db79cb1cc16887446 Mon Sep 17 00:00:00 2001
From: Christoph Knittel <ck@cca.io>
Date: Fri, 25 Jul 2025 16:17:02 +0200
Subject: [PATCH 1/2] Add node version check

---
 cli/common/bins.js | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/cli/common/bins.js b/cli/common/bins.js
index 77f3e2be48..6007f09151 100644
--- a/cli/common/bins.js
+++ b/cli/common/bins.js
@@ -1,5 +1,7 @@
 // @ts-check
 
+const minimumNodeVersion = "20.11.0";
+
 /**
  * @typedef {import("@rescript/linux-x64")} BinaryModuleExports
  */
@@ -23,6 +25,9 @@ if (supportedPlatforms.includes(target)) {
   try {
     mod = await import(binPackageName);
   } catch {
+    // First check if we are on an unsupported node version, as that may be the cause for the error.
+    checkNodeVersionSupported();
+
     throw new Error(
       `Package ${binPackageName} not found. Make sure the rescript package is installed correctly.`,
     );
@@ -43,3 +48,26 @@ export const {
     rescript_exe,
   },
 } = mod;
+
+function checkNodeVersionSupported() {
+  if (
+    typeof process !== "undefined" &&
+    process.versions != null &&
+    process.versions.node != null
+  ) {
+    const currentVersion = process.versions.node;
+    const required = minimumNodeVersion.split(".").map(Number);
+    const current = currentVersion.split(".").map(Number);
+    if (
+      current[0] < required[0] ||
+      (current[0] === required[0] && current[1] < required[1]) ||
+      (current[0] === required[0] &&
+        current[1] === required[1] &&
+        current[2] < required[2])
+    ) {
+      throw new Error(
+        `ReScript requires Node.js >=${minimumNodeVersion}, but found ${currentVersion}.`,
+      );
+    }
+  }
+}

From 7475336d06fafc1e65119c4d9b66cdf1eef7b9b4 Mon Sep 17 00:00:00 2001
From: Christoph Knittel <ck@cca.io>
Date: Sat, 26 Jul 2025 10:25:09 +0200
Subject: [PATCH 2/2] CHANGELOG

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 259e10926c..5adb098543 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,7 @@
 
 - Apply heuristic to suggest using JSX fragments where we guess that might be what the user wanted. https://github.com/rescript-lang/rescript/pull/7714
 - Show deprecation warnings for `bs-dependencies` etc. for local dependencies only. https://github.com/rescript-lang/rescript/pull/7724
+- Add check for minimum required node version. https://github.com/rescript-lang/rescript/pull/7723
 
 #### :bug: Bug fix