Skip to content

feat!: require Node.js 22 or newer #2670

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
josephfusco merged 3 commits into from
Oct 22, 2026
Merged

feat!: require Node.js 22 or newer #2670

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f3e1f3d
feat!: require Node.js 22 or newer
josephfusco Oct 20, 2026
8e81127
docs: word the Node.js 20 fallback the same way in the README and dep…
josephfusco Oct 20, 2026
b7a26cd
docs: recommend the latest release of a supported Node.js version
josephfusco Oct 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Faust.js is a toolkit for building Next.js applications for headless WordPress s

### Front end

- Node.js 22 or newer and npm 8 or newer. Node.js 20 and older have reached end of life and are no longer tested.
- Node.js 22 or newer and npm 8 or newer. Use the latest release of a [supported version](https://nodejs.org/en/about/previous-releases) so you have its security fixes. Node.js 20 has reached end of life. If you need to stay on it, use `@faustwp/core` and `@faustwp/cli` 3.x and `@faustwp/blocks` 6.x.
- Next.js 12.1.6 or newer with the Pages Router (15.5.5 or newer if you use `@faustwp/blocks`). The examples and tests use Next.js 16.
- React 17.0.2 or newer, and at least the version your Next.js release requires (18.2 for Next.js 16).
- Apollo Client 3.6.6 or newer, below 4 (3.14 or newer if you use `@faustwp/blocks`).
Expand Down
2 changes: 1 addition & 1 deletion docs/explanation/deploy-your-app/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ The following explains the various options for deploying your Faust.js App to pr

## Picking The Right Node.js Version

Faust.js supports Node.js 22 or newer, so check that your hosting provider builds and runs your app on a compatible version. Node.js 20 and older have reached end of life and are no longer tested. The [latest LTS version](https://nodejs.org/en/about/previous-releases) of Node.js is recommended.
Faust.js requires Node.js 22 or newer, so check that your hosting provider builds and runs your app on a compatible version. Node.js 20 has reached end of life. If you need to stay on it, use `@faustwp/core` and `@faustwp/cli` 3.x and `@faustwp/blocks` 6.x. Use the latest release of an [LTS version](https://nodejs.org/en/about/previous-releases) so your app has its security fixes.

## Building Your App

Expand Down
5 changes: 2 additions & 3 deletions examples/next/block-support/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
"@wordpress/scripts": "^32.5.0"
},
"engines": {
"node": ">=20.9.0",
"node": ">=22",
"npm": ">=10"
},
"overrides": {
Expand All @@ -49,8 +49,7 @@
"linkify-it": ">=5.0.1",
"markdown-it": ">=14.2.0",
"markdownlint": ">=0.41.0",
"markdownlint-cli": ">=0.49.0",
"vitest": "4.1.11"
"markdownlint-cli": ">=0.49.0"
},
"resolutions": {
"@babel/runtime": "7.27.0"
Expand Down
5 changes: 1 addition & 4 deletions examples/next/faustwp-getting-started/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,7 @@
"next-secure-headers": "^2.2.0"
},
"engines": {
"node": ">=20.9",
"node": ">=22",
"npm": ">=8"
},
"overrides": {
"vitest": "4.1.11"
}
}
10 changes: 5 additions & 5 deletions package-lock.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "@faustjs/root",
"private": true,
"engines": {
"node": ">=18",
"node": ">=22",
"npm": ">=8"
},
"workspaces": {
Expand Down
2 changes: 1 addition & 1 deletion packages/blocks/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
},
"homepage": "https://github.com/wpengine/faustjs#readme",
"engines": {
"node": ">=18",
"node": ">=22",
"npm": ">=8"
},
"publishConfig": {
Expand Down
2 changes: 1 addition & 1 deletion packages/faustwp-cli/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@
},
"homepage": "https://github.com/wpengine/faustjs#readme",
"engines": {
"node": ">=18",
"node": ">=22",
"npm": ">=8"
},
"publishConfig": {
Expand Down
2 changes: 1 addition & 1 deletion packages/faustwp-core/package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@
},
"homepage": "https://github.com/wpengine/faustjs#readme",
"engines": {
"node": ">=18",
"node": ">=22",
"npm": ">=8"
},
"publishConfig": {
Expand Down
Loading