Error when install dependencies

[paulocoutinhox]

Hi,

Im following the README file to install basic deps for R3F and get this error:

npm install three @types/three @react-three/fiber
npm error code ERESOLVE
npm error ERESOLVE unable to resolve dependency tree
npm error
npm error While resolving: undefined@undefined
npm error Found: react-dom@18.3.1
npm error node_modules/react-dom
npm error   peer react-dom@"^18.0.0" from react-native-web@0.19.13
npm error   node_modules/react-native-web
npm error     peerOptional react-native-web@"*" from expo-gl@15.0.4
npm error     node_modules/expo-gl
npm error       peerOptional expo-gl@">=11.0" from @react-three/fiber@9.1.0
npm error       node_modules/@react-three/fiber
npm error         @react-three/fiber@"*" from the root project
npm error
npm error Could not resolve dependency:
npm error peerOptional react-dom@"^19.0.0" from @react-three/fiber@9.1.0
npm error node_modules/@react-three/fiber
npm error   @react-three/fiber@"*" from the root project
npm error
npm error Fix the upstream dependency conflict, or retry
npm error this command with --force or --legacy-peer-deps
npm error to accept an incorrect (and potentially broken) dependency resolution.
npm error
npm error
npm error For a full report see:
npm error /Users/paulo/.npm/_logs/2025-03-14T22_41_39_320Z-eresolve-report.txt
npm error A complete log of this run can be found in: /Users/paulo/.npm/_logs/2025-03-14T22_41_39_320Z-debug-0.log

Can you help me?

Thanks.

[thenameisvaibhav]

I may be wrong, but I use vite and after i install r3f on it and it doesn't show any error, there may be problem because of react version or vite version

[bortch]

Same error here. Fresh install on react-native (expo).

[bortch]

Same error here. Fresh install on react-native (expo).

I managed to get it to work with a few command lines.
As mentioned above, this is a version problem.

Load the latest version of React Native CLI

npx @react-native-community/cli@latest init myApp --version latest

cd myApp

Fix to React 19

npm install --save-exact react@^19.0.0 react-dom@^19.0.0

Install dependencies

npm install expo-three three @react-three/fiber @react-three/drei

Optional force fix

npm audit fix --force

[AntoineHessAcernis]

Hello !
I have the same error with the same version of React : "18.3.1".
Am I forced to update React to version 19 ? The documentation should be updated in this case.
Thanks !

[krispya]

Hello, R3F v9 is only compatible with React 19 while R3F v8 is compatible with React 18. We should definitely update the docs with this!

[drcmda]

I've added it to the docs and readme's. Sorry for the confusion, fiber is like react-dom (react-native, etc), it's a react renderer. You can't pair react-dom 18 with react 19, same with fiber. That's because react-renderers rely on react internals, like the reconciler and "fiber" architecture (where the name "r3-fiber" came from).

v8 pairs to react 18, v9 pairs to react 19. There's a v10 in alpha but that's more about upcoming features.

here's the migration guide https://r3f.docs.pmnd.rs/tutorials/v9-migration-guide the only real breaking change is just strict mode, though. and if it affects your code, it merely points to a bug in it. v8 didn't forward outward strict mode into its canvas.