[DennisSmolek]

Depends on #787 (foundation: yarn 4, r3f 10 canary, drei 11 alpha, three 0.186). This branch is based on feat/3.0-foundation; rebase onto next once #787 merges.

What

• Renderer toggle (sidebar: WebGPU / WebGL). Defaults to WebGPU when navigator.gpu exists, else WebGL; ?renderer=webgl|webgpu overrides and the choice is kept in localStorage. Uses the r3f root-entry Canvas (renderer={...} for WebGPU, gl={...} for WebGL). Switching reloads the page so a canvas never changes renderer.
• Auto-discovered examples: demo/src/examples.ts uses import.meta.glob + React.lazy. examples/<folder>/index.ts(x) default-exports the component and may export meta { title, description, webglOnly }. Folders without an index still register (every *Example*.tsx becomes a route), so character-controller (feat: kinematic character controller (useCharacterController + <CharacterController>) #783) and soft-bodies (feat: soft bodies (SoftBody, useSoftBody) #786) need no App.tsx edits after rebasing. Documented in DEVELOPMENT.md. useDemo/Demo moved to demo-context.ts and are re-exported from App.tsx, so existing imports keep working.
• Demo is broken in various ways ("Debug" button, Cradle demo and Plinko demo - possibly more) #666: Cradle (no tilted group, fixed anchor, restitution 1, planar revolute joints, no overlapping rod colliders, rod 5 pulled out), Debug toggle (toggled 4x on both renderers, no context loss or errors), Plinko (works on both renderers, items fall through the pegs; not reproducible on current code).
• Vehicle example (Create react api for DynamicRayCastVehicleController #323, DynamicRayCastVehicleController wheels are affected by sensors #693): copy-paste raycast vehicle on DynamicRayCastVehicleController, updateVehicle(dt, QueryFilterFlags.EXCLUDE_SENSORS), a sensor zone the wheel rays must ignore, ramp and boxes, WASD/arrows + Space, camera follows.

WebGPU audit

No example needed webglOnly (the flag and a notice exist for future use).

• Sensors: troika <Text> (WebGL ShaderMaterial) replaced by drei <Html>.
• drei 11 alpha still reads state.gl (null on WebGPU roots in r3f 10): <Html> crashed with gl.domElement and useTexture with gl.initTexture (all-colliders, all-shapes, dynamic-type-change, locked-transforms, damping, snapshot). The demo sets state.gl = renderer on WebGPU roots (GlShim in App.tsx, commented, remove when drei uses state.renderer). Worth reporting upstream.
• Immutable props: guard against a null ref during leva-driven remount.
• Not used in the demo: onBeforeCompile, postprocessing, csg (the @react-three/csg dep is unused).

Verification

The Claude in Chrome extension was not connected, so I drove the dev server with headless Chrome (playwright-core, WebGPU enabled, which works), visiting every route on both renderers, collecting console errors/page errors and screenshots; also spot-checked cradle/vehicle/debug interactively by key presses. yarn typecheck, yarn test (38 tests), yarn demo:build pass.

Example	WebGPU	WebGL
active-collision-types	ok (1)	ok
all-colliders	ok	ok
all-shapes	ok	ok
api-usage	ok	ok
attractors	ok (2)	ok (2)
car	ok	ok
cluster	ok (2)	ok (2)
colliders	ok	ok
collision-events	ok	ok
components	ok	ok
contact-force-events	ok	ok
contact-skin	ok	ok
cradle	ok	ok
damping	ok	ok
dynamic-type-change	ok	ok
immutable-props	ok	ok
instanced-meshes	ok (2)	ok (2)
instances-meshes-compound	ok (2)	ok (2)
joints	ok (1)	ok
kinematics	ok	ok
locked-transforms	ok	ok
manual-step	ok	ok
mesh-collider-test	ok	ok
one-way-platform	ok	ok
performance	ok	ok
plinko	ok	ok
rope-joint	ok (1)	ok
sensors	ok	ok
snapshot	ok	ok
spring	ok (1)	ok
stuttering	ok	ok
transforms	ok	ok
vehicle	ok (1)	ok

1. Intermittent WebGPU validation error Destroyed texture "PMREM.cubeUv" used in a submit (drei <Environment> under StrictMode); varies per run, rendering was fine in screenshots. Not fixed.
2. React warning "props object containing a key prop is being spread" from InstancedRigidBodies ({...instance} includes key), on both renderers. Library-side fix (const { key, ...rest } = instance); left alone because fix/3.0-bugfixes also edits that file.

Also: a harmless 404 (likely favicon) and drei's RGBELoader deprecation warning appear in the console.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 452d9eb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@react-three/rapier	Major
@react-three/rapier-addons	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR