Installation

Install r3f-xr-widgets and its peer dependencies:

pnpm

pnpm add r3f-xr-widgets
pnpm add react react-dom three @react-three/fiber @react-three/drei @react-three/xr @react-three/handle

npm

npm install r3f-xr-widgets
npm install react react-dom three @react-three/fiber @react-three/drei @react-three/xr @react-three/handle

yarn

yarn add r3f-xr-widgets
yarn add react react-dom three @react-three/fiber @react-three/drei @react-three/xr @react-three/handle

Peer Dependencies

r3f-xr-widgets requires the following peer dependencies:

• react >=18
• react-dom >=18
• three >=0.150.0
• @react-three/fiber >=8.0.0
• @react-three/drei >=9.0.0
• @react-three/xr >=5.0.0
• @react-three/handle >=6.0.0

Version Compatibility

The library is built with and tested against:

• React 19
• Three.js 0.165+
• React Three Fiber 9.3+
• @react-three/xr 6.6+

Next Steps

Continue to Quick Start to create your first XR scene.