chore: drop support for Node 18, that reached End-of-Life

.github/workflows/tests-e2e.yml

@@ -38,7 +38,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: ['18.0', '20', '22', '24']
+        node: ['20.0', '20', '22', '24']
     steps:
       - name: Checkout
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0

.github/workflows/tests-windows.yml

@@ -27,7 +27,7 @@ jobs:
     runs-on: windows-latest
     strategy:
       matrix:
-        node: ['18.0', '20', '22', '24']
+        node: ['20.0', '20', '22', '24']
     steps:
       - name: Support longpaths
         run: git config --system core.longpaths true

.github/workflows/tests.yml

@@ -27,7 +27,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: ['18.0', '20', '22', '24']
+        node: ['20.0', '20', '22', '24']
     steps:
       - name: Checkout
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0

packages/create-docusaurus/package.json

@@ -37,6 +37,6 @@
     "@types/supports-color": "^8.1.1"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/create-docusaurus/templates/classic-typescript/package.json

@@ -42,6 +42,6 @@
     ]
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/create-docusaurus/templates/classic/package.json

@@ -39,6 +39,6 @@
     ]
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/create-docusaurus/templates/shared/docs/intro.md

@@ -14,7 +14,7 @@ Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new
 
 ### What you'll need
 
-- [Node.js](https://nodejs.org/en/download/) version 18.0 or above:
+- [Node.js](https://nodejs.org/en/download/) version 20.0 or above:
   - When installing Node.js, you are recommended to check all checkboxes related to dependencies.
 
 ## Generate a new site

packages/docusaurus-babel/package.json

@@ -45,6 +45,6 @@
     "tslib": "^2.6.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-bundler/package.json

@@ -55,6 +55,6 @@
     "@total-typescript/shoehorn": "^0.1.2"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-cssnano-preset/package.json

@@ -26,6 +26,6 @@
     "to-vfile": "^6.1.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-faster/package.json

@@ -29,7 +29,7 @@
     "webpack": "^5.95.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "peerDependencies": {
     "@docusaurus/types": "*"

packages/docusaurus-logger/package.json

@@ -24,7 +24,7 @@
     "tslib": "^2.6.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "devDependencies": {
     "@types/supports-color": "^8.1.1"

packages/docusaurus-mdx-loader/package.json

@@ -62,6 +62,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-client-redirects/package.json

@@ -36,6 +36,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-content-blog/package.json

@@ -56,7 +56,7 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "devDependencies": {
     "@total-typescript/shoehorn": "^0.1.2",

packages/docusaurus-plugin-content-docs/package.json

@@ -65,6 +65,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-content-pages/package.json

@@ -32,6 +32,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-css-cascade-layers/package.json

@@ -25,6 +25,6 @@
     "tslib": "^2.6.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-debug/package.json

@@ -32,6 +32,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-google-analytics/package.json

@@ -28,6 +28,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-google-gtag/package.json

@@ -29,6 +29,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-google-tag-manager/package.json

@@ -28,6 +28,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-ideal-image/package.json

@@ -45,6 +45,6 @@
     }
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-pwa/package.json

@@ -49,6 +49,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-rsdoctor/package.json

@@ -30,6 +30,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-sitemap/package.json

@@ -36,6 +36,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-svgr/package.json

@@ -32,6 +32,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-plugin-vercel-analytics/package.json

@@ -31,6 +31,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-preset-classic/package.json

@@ -39,6 +39,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-remark-plugin-npm2yarn/package.json

@@ -30,6 +30,6 @@
     "to-vfile": "^6.1.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-classic/package.json

@@ -60,6 +60,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-common/package.json

@@ -56,6 +56,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-live-codeblock/package.json

@@ -42,6 +42,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-mermaid/package.json

@@ -55,6 +55,6 @@
     }
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-search-algolia/package.json

@@ -58,6 +58,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-theme-translations/package.json

@@ -30,6 +30,6 @@
     "lodash": "^4.17.21"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-utils-common/package.json

@@ -23,6 +23,6 @@
     "tslib": "^2.6.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-utils-validation/package.json

@@ -31,6 +31,6 @@
     "tmp-promise": "^3.0.3"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus-utils/package.json

@@ -41,7 +41,7 @@
     "webpack": "^5.88.1"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "devDependencies": {
     "@types/dedent": "^0.7.0",

packages/docusaurus/package.json

@@ -96,6 +96,6 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/docusaurus/src/server/i18n.ts

@@ -76,6 +76,7 @@ function getDefaultDirection(localeStr: string) {
   // see https://github.com/tc39/proposal-intl-locale-info
   // see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/getTextInfo
   // Node 18.0 implements a former version of the getTextInfo() proposal
+  // TODO Docusaurus v4: remove the fallback to locale.textInfo
   // @ts-expect-error: The TC39 proposal was updated
   const textInto = locale.getTextInfo?.() ?? locale.textInfo;
   return textInto.direction;

packages/eslint-plugin/package.json

@@ -31,6 +31,6 @@
     "eslint": ">=6"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   }
 }

packages/lqip-loader/package.json

@@ -24,7 +24,7 @@
     "tslib": "^2.6.0"
   },
   "engines": {
-    "node": ">=18.0"
+    "node": ">=20.0"
   },
   "devDependencies": {
     "@types/file-loader": "^5.0.1"

website/community/5-release-process.mdx

@@ -49,6 +49,12 @@ If you only use our [public API surface](#public-api-surface), you should be abl
 
 :::
 
+:::caution About End-of-Life Node.js versions
+
+We may drop support for End-of-Life Node.js versions in minor Docusaurus versions. Check the [Node.js support policy](#nodejs-support) section for more details.
+
+:::
+
 ### Patch versions {#patch-versions}
 
 The `patch` version number is incremented on bugfixes releases.
@@ -57,6 +63,16 @@ Whenever a new patch version is released, we publish:
 
 - an exhaustive changelog entry
 
+## Node.js support policy {#nodejs-support}
+
+Each major version of Docusaurus supports a minimum Node.js version. This retro-compatibility will be preserved all along that release line. This runtime backward compatibility will be preserved throughout all the minor versions of the release line, except for End-of-Life Node.js versions.
+
+:::caution Support for End-of-Life versions
+
+On minor releases, we reserve the right to drop support for Node.js versions that reached End-of-Life ([Node.js release process and schedule](https://nodejs.org/en/about/previous-releases). **We do not consider it a Docusaurus breaking change**. We highly recommend using a maintained Node.js version. Beware that [End-of-Life Node.js versions do not receive security updates anymore](https://nodejs.org/en/blog/announcements/node-18-eol-support).
+
+:::
+
 ## Versions {#versions}
 
 ```mdx-code-block

website/docs/installation.mdx

@@ -21,7 +21,7 @@ Use **[docusaurus.new](https://docusaurus.new)** to test Docusaurus immediately
 
 ## Requirements {#requirements}
 
-- [Node.js](https://nodejs.org/en/download/) version 18.0 or above (which can be checked by running `node -v`). You can use [nvm](https://github.com/nvm-sh/nvm) to manage multiple Node.js versions on a single machine.
+- [Node.js](https://nodejs.org/en/download/) version 20.0 or above (which can be checked by running `node -v`). You can use [nvm](https://github.com/nvm-sh/nvm) to manage multiple Node.js versions on a single machine.
   - When installing Node.js, it is recommended to check all checkboxes related to dependencies.
 
 ## Scaffold project website {#scaffold-project-website}