Skip to content

RFC: Raise the minimum Node.js version to 22 in the next major #2658

Closed

Description

@josephfusco

Idea

Raise the minimum Node.js version to 22 in the next major release of the Faust.js packages.

Reasoning

Node.js 20 reached end of life in April 2026 and no longer gets security fixes. #2653 stops testing it in CI, but the packages still declare engines.node: >=18, so npm doesn't warn anyone installing on an unsupported version. Ecosystem breakages now land only on Node 20. One example: a partial vitest release on Oct 15, 2026 crashed npm 10.8, the npm that ships with Node 20, on a fresh install of our examples, which needed a temporary pin (#2651).

Raising engines is a breaking change, so it waits for a major release:

Package Current Next major
@faustwp/core 3.x 4.0.0
@faustwp/cli 3.x 4.0.0
@faustwp/blocks 6.x 7.0.0

Sites that need to stay on Node 20 keep working on core and cli 3.x and blocks 6.x. The FaustWP plugin isn't affected.

Steps

If agreed:

Activity

  1. added
    Breaking ChangeChanges behavior that existing sites depend on
    [Area] CompatibilityWordPress, Next.js, Node.js, and third-party compatibility
    Needs DiscussionAnything that needs a discussion/agreement
    on Oct 16, 2026
  2. pinned this issue on Oct 20, 2026
  3. moved this from 🆕 Backlog to ✅ Closed in Headless OSSon Oct 22, 2026
  4. josephfusco commented on Oct 22, 2026

    @josephfusco
    MemberAuthor

    Done in #2670, announced in #2672. Core and cli 4.0.0 and blocks 7.0.0 will require Node.js 22 or newer; sites on Node.js 20 can stay on core and cli 3.x and blocks 6.x.

  5. unpinned this issue on Oct 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Breaking ChangeChanges behavior that existing sites depend onNeeds DiscussionAnything that needs a discussion/agreement[Area] CompatibilityWordPress, Next.js, Node.js, and third-party compatibility

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions