Revert the move of React Compiler support into a plugin

Reverts 6e6a0bb, f29fb85 and 1ec63f2. The framework has no
settled interface for plugins to update the Vite config, so keep the
react_compiler config flag for now and move it into a plugin once that
interface exists, as suggested in review.

Claude-Session: https://claude.ai/code/session_01URTf7ThCUgaCpZGXmgPo7f

Author: claude

docs/advanced_onboarding/configuration.md

@@ -143,26 +143,26 @@ See the [plugins reference](/docs/api-reference/plugins/) for the available plug
 
 ## React Compiler (Experimental)
 
-React Compiler adds automatic memoization to generated React components. It is disabled by default. To try it, add `ReactCompilerPlugin` to the plugins in `rxconfig.py`:
+React Compiler adds automatic memoization to generated React components. It is disabled by default. To try it, set `react_compiler=True` in `rxconfig.py`:
 
 ```python
 config = rx.Config(
     app_name="my_app_name",
-    plugins=[rx.plugins.ReactCompilerPlugin()],
+    react_compiler=True,
 )
 ```
 
 Or enable it with an environment variable:
 
 ```bash
-REFLEX_EXTRA_PLUGINS="reflex.plugins.ReactCompilerPlugin" uv run reflex run
+REFLEX_REACT_COMPILER=true uv run reflex run
 ```
 
-This plugin targets Reflex's supported React 19 runtime and runs in both development and production. It compiles generated JavaScript and JSX in `app/`, `app_components/`, and `utils/components/`. Other runtime utilities and installed dependencies are excluded. Existing Reflex memoization remains enabled.
+This option targets Reflex's supported React 19 runtime and runs in both development and production. It compiles generated JavaScript and JSX in `app/`, `app_components/`, and `utils/components/`. Other runtime utilities and installed dependencies are excluded. Existing Reflex memoization remains enabled.
 
 The compiler adds build time and memory overhead. Runtime performance depends on the workload: it can avoid repeated calculations during unrelated state updates, but list-heavy updates can become slower. Measure your application's interactions before enabling it in production.
 
-Restart `reflex run` after adding or removing the plugin, and rebuild production output. Removing it drops the compiler transform and its build dependencies on the next frontend install, unless another plugin requires those dependencies.
+Restart `reflex run` after changing the flag, and rebuild production output. Disabling the flag removes the compiler transform and its optional build dependencies on the next frontend install, unless another component or plugin requires those dependencies.
 
 ## Customizable App Data Directory
 

docs/api-reference/plugins.md

@@ -109,17 +109,6 @@ config = rx.Config(
 )
 ```
 
-### ReactCompilerPlugin
-
-The `ReactCompilerPlugin` compiles generated components with the experimental [React Compiler](https://react.dev/learn/react-compiler), which adds automatic memoization. See [React Compiler](/docs/advanced-onboarding/configuration/#react-compiler-experimental) for its scope and performance tradeoffs.
-
-```python
-config = rx.Config(
-    app_name="my_app",
-    plugins=[rx.plugins.ReactCompilerPlugin()],
-)
-```
-
 ### TailwindV3Plugin
 
 The `TailwindV3Plugin` integrates Tailwind CSS v3 into your Reflex application. While still supported, TailwindV4Plugin is recommended for new projects.
@@ -214,10 +203,6 @@ class Plugin:
         """Get paths to stylesheets required by the plugin."""
         return []
 
-    def get_vite_plugins(self, **context) -> Sequence[VitePlugin]:
-        """Get Vite plugins to add to the generated vite.config.js."""
-        return []
-
     def register_route(self, **context) -> None:
         """Contribute pages before the app's first compilation."""
         pass
@@ -265,27 +250,6 @@ config = rx.Config(
 )
 ```
 
-### Adding Vite Plugins
-
-A plugin can add [Vite plugins](https://vite.dev/guide/using-plugins) to the generated `vite.config.js` by returning `VitePlugin` entries from `get_vite_plugins`. Each entry imports the module's default export under a name the framework generates, so plugins never clash, and calls it with `args`, a JavaScript source string. `module` is an npm package (declare it as a frontend dependency) or a path relative to `.web`, such as a Vite plugin shipped as a static asset:
-
-```python
-from pathlib import Path
-
-from reflex.plugins import Plugin, VitePlugin
-
-
-class BannerPlugin(Plugin):
-    def get_static_assets(self, **context):
-        source = Path(__file__).with_name("vite-plugin-banner.js").read_text()
-        return [(Path("vite-plugin-banner.js"), source)]
-
-    def get_vite_plugins(self, **context):
-        return [VitePlugin(module="./vite-plugin-banner.js", args='{text: "hi"}')]
-```
-
-Vite plugins are placed before React Router's, in plugin configuration order. Set the Vite plugin's `enforce` property to order it relative to Vite's and React Router's own transforms.
-
 ### Contributing Pages
 
 A plugin can contribute pages by overriding `register_route`. The hook runs

news/+react-compiler-opt-in.feature.md

@@ -1 +1 @@
-Add the experimental `rx.plugins.ReactCompilerPlugin`, which compiles generated components with React Compiler in development and production. Enable it with `plugins=[rx.plugins.ReactCompilerPlugin()]` in `rxconfig.py`.
+Add an experimental, default-off `react_compiler` configuration flag to enable React Compiler memoization for generated components in development and production.

packages/reflex-base/news/+react-compiler-opt-in.feature.md

@@ -1 +1 @@
-Add the experimental `ReactCompilerPlugin`, and a `Plugin.get_vite_plugins()` hook that lets plugins add Vite plugins to the generated `vite.config.js` instead of patching its text.
+Add the experimental `react_compiler` configuration option, also available as `REFLEX_REACT_COMPILER`, to opt in to automatic React component memoization.

…se/plugins/vite-plugin-react-compiler.js …plates/web/vite-plugin-react-compiler.jspackages/reflex-base/src/reflex_base/plugins/vite-plugin-react-compiler.js renamed to packages/reflex-base/src/reflex_base/.templates/web/vite-plugin-react-compiler.js packages/reflex-base/src/reflex_base/plugins/vite-plugin-react-compiler.js renamed to packages/reflex-base/src/reflex_base/.templates/web/vite-plugin-react-compiler.js

@@ -4,7 +4,7 @@
 
 import json
 import re
-from collections.abc import Iterable, Mapping, Sequence
+from collections.abc import Iterable, Mapping
 from typing import TYPE_CHECKING, Any, Literal
 
 from reflex_base import constants
@@ -16,7 +16,6 @@
 if TYPE_CHECKING:
     from reflex.compiler.utils import _ImportDict
     from reflex_base.components.component import Component
-    from reflex_base.plugins.base import VitePlugin
 
 
 def _sort_hooks(
@@ -735,7 +734,7 @@ def vite_config_template(
     allowed_hosts: bool | list[str] = False,
     prod_react: bool = False,
     warmup_routes: bool = False,
-    plugins: Sequence[VitePlugin] = (),
+    react_compiler: bool = False,
 ):
     """Template for vite.config.js.
 
@@ -751,7 +750,7 @@ def vite_config_template(
             (dev server only; see REFLEX_DEV_PROD_REACT).
         warmup_routes: Pre-transform every route module when the dev server
             starts, so the first visit to a page does not wait on Vite.
-        plugins: Vite plugins contributed by Reflex plugins, placed before React Router's.
+        react_compiler: Enable React Compiler for generated components.
 
     Returns:
         Rendered vite.config.js content as string.
@@ -848,19 +847,17 @@ def vite_config_template(
         if warmup_routes
         else ""
     )
-    plugin_imports = "".join(
-        f"import reflexVitePlugin{index} from {json.dumps(plugin.module)};\n"
-        for index, plugin in enumerate(plugins)
-    )
-    plugin_calls = "".join(
-        f"    reflexVitePlugin{index}({plugin.args}),\n"
-        for index, plugin in enumerate(plugins)
+    react_compiler_import = (
+        'import reactCompiler from "./vite-plugin-react-compiler.js";\n'
+        if react_compiler
+        else ""
     )
+    react_compiler_plugin = "    reactCompiler(),\n" if react_compiler else ""
     return rf"""import {{ fileURLToPath, URL }} from "url";
 import {{ reactRouter }} from "@react-router/dev/vite";
 import {{ defineConfig }} from "vite";
 import safariCacheBustPlugin from "./vite-plugin-safari-cachebust.js";
-{plugin_imports}
+{react_compiler_import}
 // Ensure that bun always uses the react-dom/server.node functions.
 function alwaysUseReactDomServerNode() {{
   return {{
@@ -927,7 +924,7 @@ def vite_config_template(
   base: "{base}",
   plugins: [
     alwaysUseReactDomServerNode(),
-{plugin_calls}    reactRouter(),
+{react_compiler_plugin}    reactRouter(),
     patchReactRouterHmrRuntime(),
     safariCacheBustPlugin(),
   ].concat({"[fullReload()]" if force_full_reload else "[]"}),

packages/reflex-base/src/reflex_base/compiler/templates.py

@@ -175,6 +175,7 @@ class BaseConfig:
         cors_allowed_origins: Comma separated list of origins that are allowed to connect to the backend API.
         vite_allowed_hosts: Allowed hosts for the Vite dev server. Set to True to allow all hosts, or provide a list of hostnames (e.g. ["myservice.local"]) to allow specific ones. Prevents 403 errors in Docker, Codespaces, reverse proxies, etc.
         react_strict_mode: Whether to use React strict mode.
+        react_compiler: Enable experimental React Compiler memoization for generated components in development and production. Defaults to False.
         frontend_compression_formats: Pre-compressed frontend asset formats to generate for production builds. Supported values are "gzip", "brotli", and "zstd". Use an empty list to disable build-time pre-compression.
         frontend_packages: Additional frontend packages to install.
         frontend_lazy_bundled_libraries: Load optional dynamic-component libraries when a dynamic component is first evaluated, rather than importing their full namespaces on every page. Defaults to False for compatibility with scripts that read window.__reflex directly.
@@ -237,6 +238,8 @@ class BaseConfig:
 
     react_strict_mode: bool = True
 
+    react_compiler: bool = False
+
     frontend_compression_formats: Annotated[
         list[str],
         SequenceOptions(delimiter=",", strip=True),

packages/reflex-base/src/reflex_base/config.py

@@ -162,6 +162,12 @@ def DEPENDENCIES(cls) -> dict[str, str]:
         "@react-router/fs-routes": _react_router_version,
         "vite": "8.3.2",
     }
+
+    REACT_COMPILER_DEV_DEPENDENCIES = {
+        "@babel/core": "7.29.7",
+        "babel-plugin-react-compiler": "1.0.0",
+    }
+
     # Force specific transitive npm deps to a single resolved version when
     # needed. Prefer a `DEV_DEPENDENCIES`/`DEPENDENCIES` pin when the package is
     # one we depend on directly: a top-level pin already satisfies and dedupes

packages/reflex-base/src/reflex_base/constants/installer.py

@@ -10,7 +10,6 @@
         base,
         compiler,
         embed,
-        react_compiler,
         shared_tailwind,
         sitemap,
         tailwind_v3,
@@ -24,7 +23,6 @@
         PostCompileContext,
         PreCompileContext,
         RegisterRouteContext,
-        VitePlugin,
         get_plugin,
     )
     from .compiler import (
@@ -36,7 +34,6 @@
         PageDefinition,
     )
     from .embed import EmbedPlugin
-    from .react_compiler import ReactCompilerPlugin
     from .sitemap import SitemapPlugin
     from .tailwind_v3 import TailwindV3Plugin
     from .tailwind_v4 import TailwindV4Plugin
@@ -54,16 +51,13 @@
         "PostBuildContext",
         "PostCompileContext",
         "PreCompileContext",
-        "ReactCompilerPlugin",
         "RegisterRouteContext",
         "SitemapPlugin",
         "TailwindV3Plugin",
         "TailwindV4Plugin",
-        "VitePlugin",
         "_ScreenshotPlugin",
         "embed",
         "get_plugin",
-        "react_compiler",
         "sitemap",
         "tailwind_v3",
         "tailwind_v4",
@@ -74,7 +68,6 @@
     "base",
     "compiler",
     "embed",
-    "react_compiler",
     "shared_tailwind",
     "sitemap",
     "tailwind_v3",
@@ -90,7 +83,6 @@
         "PostCompileContext",
         "PreCompileContext",
         "RegisterRouteContext",
-        "VitePlugin",
         "get_plugin",
     ],
     "compiler": [
@@ -102,7 +94,6 @@
         "PageDefinition",
     ],
     "embed": ["EmbedPlugin"],
-    "react_compiler": ["ReactCompilerPlugin"],
     "sitemap": ["SitemapPlugin"],
     "tailwind_v3": ["TailwindV3Plugin"],
     "tailwind_v4": ["TailwindV4Plugin"],

packages/reflex-base/src/reflex_base/plugins/__init__.py

@@ -1,6 +1,5 @@
 """Base class for all plugins."""
 
-import dataclasses
 from collections.abc import Callable, Mapping, Sequence
 from enum import Enum
 from pathlib import Path
@@ -119,21 +118,6 @@ class PostBuildContext(CommonContext):
     static_dir: Path
 
 
-@dataclasses.dataclass(frozen=True, kw_only=True)
-class VitePlugin:
-    """A Vite plugin added to the generated ``vite.config.js``.
-
-    The framework imports the module's default export under a generated name, so
-    contributions never collide, and calls it with ``args`` in the config's
-    ``plugins`` array.
-    """
-
-    # Import specifier: an npm package, or a path relative to ``.web``.
-    module: str
-    # JavaScript source of the call arguments.
-    args: str = ""
-
-
 class Plugin:
     """Base class for all plugins."""
 
@@ -194,22 +178,6 @@ def get_stylesheet_paths(self, **context: Unpack[CommonContext]) -> Sequence[str
         """
         return []
 
-    def get_vite_plugins(
-        self, **context: Unpack[CommonContext]
-    ) -> Sequence[VitePlugin]:
-        """Get the Vite plugins to add to the generated ``vite.config.js``.
-
-        They are placed before React Router's plugins, in configuration order.
-        A Vite plugin's ``enforce`` property still orders it among the others.
-
-        Args:
-            context: The context for the plugin.
-
-        Returns:
-            The Vite plugins to add.
-        """
-        return []
-
     def register_route(self, **context: Unpack[RegisterRouteContext]) -> None:
         """Contribute pages before the app's first compilation.