Skip to content

docs: match Node.js version requirement to package.json engines#3714

Open
andromia3 wants to merge 1 commit intoShopify:mainfrom
andromia3:docs/update-node-version
Open

docs: match Node.js version requirement to package.json engines#3714
andromia3 wants to merge 1 commit intoShopify:mainfrom
andromia3:docs/update-node-version

Conversation

@andromia3
Copy link
Copy Markdown

The root `package.json` declares `"engines": { "node": "^22 || ^24" }`, but three user-facing docs claim older, incorrect minimums. Users following any of these hit a hard install failure because the engines constraint excludes Node 16, 18, 20, and 23.

Changes

```diff

  • README.md: Node.js version 18.0.0 or higher -> Node.js 22.x or 24.x
  • CONTRIBUTING.md: Node.js version 16.14.0 or higher -> Node.js 22.x or 24.x
  • templates/skeleton/README.md: Node.js version 18.0.0 or higher -> Node.js 22.x or 24.x
    ```

The wording `22.x or 24.x` was chosen to match the shape of `^22 || ^24` precisely (LTS-only, Node 23 excluded).

Scope limited to authoritative user-facing docs. Cookbook recipe READMEs and LLM prompt files also carry the old `18.0.0 or higher` string, but those are generated by `cookbook.ts` from the skeleton template, so they should refresh on the next regeneration rather than be edited by hand.

No code or functional changes, no changeset needed.

@andromia3 andromia3 requested a review from a team as a code owner April 14, 2026 14:21
The root package.json declares "engines": { "node": "^22 || ^24" },
but three user-facing docs claimed a much older minimum:

- README.md                       -> "Node.js version 18.0.0 or higher"
- CONTRIBUTING.md                  -> "Node.js version 16.14.0 or higher"
- templates/skeleton/README.md     -> "Node.js version 18.0.0 or higher"

Users following any of these will fail install because ^22 || ^24
excludes Node 16, 18, 20, and 23. Updated all three to "Node.js 22.x
or 24.x" to match the engines field.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant