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
Goal
Bump
package.jsonengines.nodefrom>=18.0.0→>=20.0.0and 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#toReversedandcrypto.hashin 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
When to act
Pick one of these triggers, whichever comes first:
enginesfields, after Node 20 itself approaches EOL (April 2026 currently scheduled).Scope when picked up
"engines": { "node": ">=20.0.0" }package.jsondocs/guides/jss-on-android.md:119docs/features/authentication.md(the docs page we added today)README.mdRefs