diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0caab26aca..d2f62bb03a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
### Changed
+- **BREAKING**: dropped Node 20.x support. Minimum Node version is now 22.22.2 (or 24.0.0+). Required because http-proxy-middleware 4.x requires `node >=22.15.0`. Users on Node 20 must upgrade — see [`package.json` engines field](package.json) and the README Node badge.
- **Platform overhaul (FASES 1-9):** scripts cleanup, `.env` audit, `/docs` restructure, diagrams folder, i18n pipelines (docs + UI), `/src/app/docs` sync, CI gates.
- **Scripts:** `scripts/` reorganized into 6 subfolders (`build/`, `dev/`, `check/`, `docs/`, `i18n/`, `ad-hoc/`); 23 one-shot scripts archived to the `archive/scripts-scratch-pre-3.8` branch.
- **Environment:** `.env.example` cleaned (-11 orphan vars, +63 missing vars, 11 hardcoded URLs/timeouts promoted to env); new strict `scripts/check/check-env-doc-sync.mjs` validates code ↔ `.env.example` ↔ `docs/reference/ENVIRONMENT.md` parity.
diff --git a/README.md b/README.md
index 5ea1659691..ddc14b83ba 100644
--- a/README.md
+++ b/README.md
@@ -56,7 +56,7 @@
[](https://www.npmjs.com/package/omniroute)
[](LICENSE)
-[](package.json)
+[](package.json)
[](https://github.com/diegosouzapw/OmniRoute)
[](https://trendshift.io/repositories/23589)
@@ -488,6 +488,6 @@ Free forever. Self-hosted. No tracking. No cloud lock-in.
**[⬆ Back to top](#-omniroute)** · Built with ❤️ for the open-source AI community.
-OmniRoute v3.8.0 · Node ≥20.20.2 · MIT License
+OmniRoute v3.8.0 · Node ≥22.22.2 · MIT License
diff --git a/package-lock.json b/package-lock.json
index 1b980cfd94..4c6fbde29d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -97,7 +97,7 @@
"wtfnode": "^0.10.1"
},
"engines": {
- "node": ">=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27"
+ "node": ">=22.22.2 <23 || >=24.0.0 <27"
},
"optionalDependencies": {
"keytar": "^7.9.0"
diff --git a/package.json b/package.json
index d639f8853e..c8306838f1 100644
--- a/package.json
+++ b/package.json
@@ -36,7 +36,7 @@
"open-sse"
],
"engines": {
- "node": ">=20.20.2 <21 || >=22.22.2 <23 || >=24.0.0 <27"
+ "node": ">=22.22.2 <23 || >=24.0.0 <27"
},
"keywords": [
"ai",