[Maintenance]: npm install shows confusing peer dependency warnings

[resourcefulmind]

Summary

What I was trying to do

Install the packages in a fresh Vite React project following the README:

npm install @solana/client @solana/react-hooks

What I expected

Clean installation with no warnings.

What actually happened

Installation succeeded, but displayed a wall of yellow warnings:

npm warn ERESOLVE overriding peer dependency
npm warn While resolving: @solana-program/compute-budget@0.9.0
npm warn Found: @solana/kit@5.1.0
npm warn Could not resolve dependency:
npm warn peer @solana/kit@"^3.0" from @solana-program/compute-budget@0.9.0
npm warn Conflicting peer dependency: @solana/kit@3.0.3
npm warn Conflicting peer dependency: @solana/kit@2.3.0

(Multiple similar warnings for different packages)

Motivation

Impact on beginners

• Beginners may think the installation failed
• "Could not resolve dependency" sounds like an error(normal devs might be used to it but we are trying to bring new folks onboard too)
• Creates uncertainty about whether to proceed
• First impression of the library is "something is broken"

Environment

• OS: macOS
• Node: v22.x
• npm: 11.x
• Fresh Vite React project (react-ts template)

Suggested improvement

Either:

1. Align internal dependency versions to avoid conflicts
2. Add a note in README: "You may see peer dependency warnings — these are safe to ignore"
3. Both

Scope / constraints

No response

Additional context

No response