Skip to content

chore: bump engines.node minimum to >=20 (and update Node-18 references in docs) #541

Description

@melvincarvalho

Goal

Bump package.json engines.node from >=18.0.0>=20.0.0 and update the docs references to match.

Why this is a separate issue from #523

#523 catches the symptom (OIDC IdP 500s on Node 18 due to Array#toReversed and crypto.hash in oidc-provider). The disposition there is "defer until Node 18 fades naturally" — see the disposition comment on #523. This issue tracks the bookkeeping work to update our advertised runtime so the docs stop lying-by-omission.

Why not now

  • Node 18 reached EOL April 2025 — user base shrinking on its own.
  • nodejs-mobile users have a working downstream-patch path on Node 18 today.
  • Bumping now would warn (not block) Node 18 installs — small disruption for diminishing returns.

When to act

Pick one of these triggers, whichever comes first:

Scope when picked up

Change File
"engines": { "node": ">=20.0.0" } package.json
Replace "Node 18+" → "Node 20+" docs/guides/jss-on-android.md:119
Note IdP requires Node 20+ docs/features/authentication.md (the docs page we added today)
Optional: README prerequisites note README.md

Refs

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions