feat: add REFLEX_HOT_RELOAD_OVERRIDE_PATHS to fully override reload paths

news/6639.feature.md

@@ -0,0 +1 @@
+Added the `REFLEX_HOT_RELOAD_OVERRIDE_PATHS` environment variable, a colon-separated list of paths that, when set, fully replaces the paths watched for hot reload in dev mode — taking precedence over the config-derived defaults as well as `REFLEX_HOT_RELOAD_INCLUDE_PATHS` and `REFLEX_HOT_RELOAD_EXCLUDE_PATHS`.

packages/reflex-base/news/6639.feature.md

@@ -0,0 +1 @@
+Added the `REFLEX_HOT_RELOAD_OVERRIDE_PATHS` environment variable, a colon-separated list of paths that, when set, fully replaces the paths watched for hot reload in dev mode.

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

@@ -642,6 +642,9 @@ class EnvironmentVariables:
     # Paths to exclude from the hot reload. Takes precedence over include paths. Separated by a colon.
     REFLEX_HOT_RELOAD_EXCLUDE_PATHS: EnvVar[list[Path]] = env_var([])
 
+    # Paths to override in the hot reload. Takes precedence over include and exclude paths. Separated by a colon.
+    REFLEX_HOT_RELOAD_OVERRIDE_PATHS: EnvVar[list[Path]] = env_var([])
+
     # Enables different behavior for when the backend would do a cold start if it was inactive.
     REFLEX_DOES_BACKEND_COLD_START: EnvVar[bool] = env_var(False)
 

reflex/utils/exec.py

@@ -500,6 +500,14 @@ def get_reload_paths() -> Sequence[Path]:
     Raises:
         RuntimeError: If the `__init__.py` file is found in the app root directory.
     """
+    override_dirs = tuple(
+        map(Path.absolute, environment.REFLEX_HOT_RELOAD_OVERRIDE_PATHS.get())
+    )
+
+    if override_dirs:
+        console.debug(f"Reload paths (override): {list(map(str, override_dirs))}")
+        return override_dirs
+
     config = get_config()
     reload_paths = [Path.cwd()]
     app_module = config.module