react-19-plugin-migration

What problem does it solve?

Migrate Grafana plugins to be forward-compatible with React 19 and prevent runtime crashes, build failures, and bundled jsx-runtime conflicts that occur when plugins or their dependencies bundle React 18 internals.

Core Features & Use Cases

• Compatibility scanning and verification: Run build and react-detect to identify jsx-runtime imports, SECRET_INTERNALS access, defaultProps/propTypes usage, and other breaking patterns.
• Automated scaffolding and dependency updates: Update create-plugin scaffolding, externalize react/jsx-runtime, bump grafanaDependency to >=12.3.0, and align @grafana/* and Faro packages.
• ESLint and source fixes plus CI validation: Migrate to ESLint v9 flat config, apply source code changes (createRoot, remove propTypes, adjust defaultProps), update CI, and re-run build/typecheck/tests to validate success.
• Use case: A plugin maintainer preparing a plugin for Grafana 13 can follow the checklist to avoid runtime ReactCurrentOwner crashes and ensure the plugin runs with Grafana's React 19 runtime.

Quick Start

Run the migration checklist on a clean branch: update create-plugin scaffolding, add externalize-jsx-runtime, bump grafanaDependency to >=12.3.0, update relevant @grafana and faro packages, complete ESLint 9 migration, rebuild, and re-run react-detect to confirm no issues.