Skip to content

fix: add explicit engines.node >=22 to root and published packages#2654

Open
0xAxiom wants to merge 1 commit into
coinbase:mainfrom
0xAxiom:fix/engines-node-requirement
Open

fix: add explicit engines.node >=22 to root and published packages#2654
0xAxiom wants to merge 1 commit into
coinbase:mainfrom
0xAxiom:fix/engines-node-requirement

Conversation

@0xAxiom
Copy link
Copy Markdown

@0xAxiom 0xAxiom commented May 22, 2026

Closes #2652.

What

Add "engines": { "node": ">=22" } to:

  • package.json (monorepo workspace root)
  • packages/onchainkit/package.json (published @coinbase/onchainkit)
  • packages/create-onchain/package.json (published create-onchain CLI)

Why

The repository already enforces Node 22 through .nvmrc and all CI workflows test exclusively on 22.x. Without an engines field, pnpm/npm silently allows installs on older Node versions, leading to confusing failures at runtime. Surfacing the constraint upfront:

  • Shows a warning during pnpm install when Node < 22
  • Surfaces the requirement on npmjs.com for library consumers
  • Reduces contributor onboarding friction

Scope

Only the workspace root and the two published packages are included. Internal-only packages (playground, miniapp-manifest-generator) were left unchanged since they are never installed as dependencies.

Closes coinbase#2652. The monorepo already pins Node 22 via .nvmrc and all CI
workflows test exclusively on 22.x, but the engines field was missing
from package.json files. Added to the workspace root, @coinbase/onchainkit,
and create-onchain so pnpm/npm warn on mismatched environments and npm
search surfaces the requirement for consumers.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 22, 2026

@0xAxiom is attempting to deploy a commit to the Coinbase Team on Vercel.

A member of the Team first needs to authorize it.

@cb-heimdall
Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

Add explicit Node.js engine requirement to package.json

2 participants