feat: add vite_allowed_hosts config option for Vite dev server (#6147)

* feat: add vite_allowed_hosts config option for Vite dev server

Add a configurable `vite_allowed_hosts` field to `rx.Config` that controls
whether `allowedHosts: true` is set in the Vite dev server configuration.

This allows users running Reflex in Docker, Codespaces, or behind a reverse
proxy to opt-in to allowing all hosts, preventing 403 Forbidden errors from
Vite's host header validation.

Default is `False` (original behavior, Vite only allows localhost).
Users can enable it in rxconfig.py:
  config = rx.Config(app_name="myapp", vite_allowed_hosts=True)
Or via environment variable:
  REFLEX_VITE_ALLOWED_HOSTS=true reflex run

* refactor: support bool | list[str] for vite_allowed_hosts

* feat: support union types in interpret_env_var_value

Instead of raising an error for union types, try each type in the union
in order and return the first successful interpretation.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Masen Furer <m_github@0x26.net>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: 3 people

reflex/compiler/templates.py

@@ -502,6 +502,7 @@ def vite_config_template(
     force_full_reload: bool,
     experimental_hmr: bool,
     sourcemap: bool | Literal["inline", "hidden"],
+    allowed_hosts: bool | list[str] = False,
 ):
     """Template for vite.config.js.
 
@@ -511,10 +512,17 @@ def vite_config_template(
         force_full_reload: Whether to force a full reload on changes.
         experimental_hmr: Whether to enable experimental HMR features.
         sourcemap: The sourcemap configuration.
+        allowed_hosts: Allow all hosts (True), specific hosts (list of strings), or only localhost (False).
 
     Returns:
         Rendered vite.config.js content as string.
     """
+    if allowed_hosts is True:
+        allowed_hosts_line = "\n    allowedHosts: true,"
+    elif isinstance(allowed_hosts, list) and allowed_hosts:
+        allowed_hosts_line = f"\n    allowedHosts: {json.dumps(allowed_hosts)},"
+    else:
+        allowed_hosts_line = ""
     return rf"""import {{ fileURLToPath, URL }} from "url";
 import {{ reactRouter }} from "@react-router/dev/vite";
 import {{ defineConfig }} from "vite";
@@ -586,7 +594,7 @@ def vite_config_template(
     hmr: {"true" if experimental_hmr else "false"},
   }},
   server: {{
-    port: process.env.PORT,
+    port: process.env.PORT,{allowed_hosts_line}
     hmr: {"true" if hmr else "false"},
     watch: {{
       ignored: [

reflex/config.py

@@ -213,6 +213,11 @@ class BaseConfig:
         dataclasses.field(default=("*",))
     )
 
+    # 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.
+    vite_allowed_hosts: bool | list[str] = False
+
     # Whether to use React strict mode.
     react_strict_mode: bool = True
 

reflex/environment.py

@@ -243,8 +243,14 @@ def interpret_env_var_value(
     field_type = value_inside_optional(field_type)
 
     if is_union(field_type):
-        msg = f"Union types are not supported for environment variables: {field_name}."
-        raise ValueError(msg)
+        errors = []
+        for arg in (union_types := get_args(field_type)):
+            try:
+                return interpret_env_var_value(value, arg, field_name)
+            except (ValueError, EnvironmentVarValueError) as e:  # noqa: PERF203
+                errors.append(e)
+        msg = f"Could not interpret {value!r} for {field_name} as any of {union_types}: {errors}"
+        raise EnvironmentVarValueError(msg)
 
     value = value.strip()
 

reflex/utils/frontend_skeleton.py

@@ -197,6 +197,7 @@ def _compile_vite_config(config: Config):
         force_full_reload=environment.VITE_FORCE_FULL_RELOAD.get(),
         experimental_hmr=environment.VITE_EXPERIMENTAL_HMR.get(),
         sourcemap=environment.VITE_SOURCEMAP.get(),
+        allowed_hosts=config.vite_allowed_hosts,
     )
 
 

tests/units/test_environment.py

@@ -190,10 +190,19 @@ def test_interpret_enum(self):
         result = interpret_env_var_value("value1", _TestEnum, "TEST_FIELD")
         assert result == _TestEnum.VALUE1
 
-    def test_interpret_union_error(self):
-        """Test that union types raise an error."""
-        with pytest.raises(ValueError, match="Union types are not supported"):
-            interpret_env_var_value("test", int | str, "TEST_FIELD")
+    def test_interpret_union_tries_each_type(self):
+        """Test that union types try each type in order."""
+        # str matches first
+        assert interpret_env_var_value("hello", int | str, "TEST_FIELD") == "hello"
+        # int matches first
+        assert interpret_env_var_value("42", int | str, "TEST_FIELD") == 42
+        # bool matches before str
+        assert interpret_env_var_value("true", bool | str, "TEST_FIELD") is True
+
+    def test_interpret_union_no_match(self):
+        """Test that union types raise an error if no type matches."""
+        with pytest.raises(EnvironmentVarValueError, match="Could not interpret"):
+            interpret_env_var_value("not_a_number", int | bool, "TEST_FIELD")
 
     def test_interpret_unsupported_type(self):
         """Test unsupported type raises an error."""