New
Introducing React Bench, see how different models perform on React code
Menu
What Is React Doctor?
Quickstart
Install for Coding Agents
How to Fix Issues
GitHub Actions Setup
Updating CI
Other CI Providers
Migrating to CI v2
Config Files
ESLint & oxlint Plugins
Add Custom Rules
CLI Reference
GitHub Action Reference
Node.js API
Changelog
Modified MIT License
Terms of Service
Privacy Policy
Data Use
Security
Support
Rules reference

react-doctor/r3f-webgpu-canvas-prop-compatibility

Incompatible R3F Canvas renderer prop

  • Category: Bugs
  • Severity: error
  • Source: oxlint-plugin-react-doctor
  • Framework: global
  • Enabled when: react, r3f, r3f:10
  • Tags: r3f, webgl, react-jsx-only
  • Default: Enabled

Validate the diagnostic

Confirm the reported code matches this rule before you edit it.

Confirm the reported code matches react-doctor/r3f-webgpu-canvas-prop-compatibility. Compare it with the Before example and verify the same API, framework, and execution context. Treat it as a false positive only when one of those conditions differs.

Compare the code

The corrected pattern shows a focused way to address the diagnostic.

Reported pattern

import { Canvas } from "@react-three/fiber/webgpu";
<Canvas gl={async () => new WebGPURenderer()} />;

Corrected pattern

import { Canvas } from "@react-three/fiber/webgpu";
<Canvas renderer={async () => new WebGPURenderer()} />;

How to fix

Use the corrected pattern as a reference. Preserve behavior that the rule does not require you to change.

Copyable fix prompt

Copy this self-contained prompt into your coding agent after you confirm the diagnostic.

Fix every confirmed react-doctor/r3f-webgpu-canvas-prop-compatibility diagnostic in the current repository. Required change: - Use renderer with @react-three/fiber/webgpu, gl with /legacy, and never pass both renderer APIs to one Canvas.
Reference transformation:Before:
import { Canvas } from "@react-three/fiber/webgpu";
<Canvas gl={async () => new WebGPURenderer()} />;
After:
import { Canvas } from "@react-three/fiber/webgpu";
<Canvas renderer={async () => new WebGPURenderer()} />;
Constraints: - Confirm the reported code matches the Before pattern. - Make the smallest change that fixes the root cause. - Preserve behavior and interfaces unrelated to this diagnostic. - Reuse existing project components, utilities, and conventions. - Do not introduce render-phase side effects, render-phase state updates, or Hooks rule violations. - Adapt identifiers and framework details instead of copying blindly. - Do not disable the rule or suppress matching code. - Confirm this rule is enabled for the project: react, r3f, r3f:10. Verification: - Run focused tests for the changed behavior. - Run React Doctor and confirm this diagnostic no longer appears. - Report the files changed and any checks you could not run.

More Bugs rules from the rules reference: