feat(ui): scaffold embedded reflex ui config

Author: fgogolli

src/orb/ui/rxconfig.py

@@ -0,0 +1,58 @@
+"""Reflex configuration for the ORB UI (packaged copy).
+
+This file ships inside the ``orb`` wheel at ``orb/ui/rxconfig.py`` so that
+``reflex run`` can find it when the package is installed from PyPI.  The
+embedded-UI runtime (``run_embedded_foreground``) sets ``cwd`` to the
+directory that contains this file before exec-ing ``reflex run``.
+
+A thin re-export at the repository root (``rxconfig.py``) delegates here so
+that ``reflex run`` from the repo root continues to work for local
+development.
+
+Note: ``reflex`` is an optional dependency (the ``[ui]`` extra).  This
+module must remain importable even when reflex is not installed so that
+pyright and other static-analysis passes that run without the UI extra do
+not raise ImportError.  The ``rx.Config`` block is only evaluated when
+reflex is actually importable (i.e. at runtime with the [ui] extra or under
+``reflex run``).
+
+# Note: pass --no-ssr when running ``reflex run`` / ``reflex export``.
+# The vaul drawer used in detail panels reads ``document`` at module
+# scope and crashes the React-Router node-side prerender.  ``orb server
+# start`` already passes this flag automatically when ``ui.enabled``.
+"""
+
+from __future__ import annotations
+
+import os
+
+# Toggle UI features via env so the same config file works for embedded
+# and remote modes.
+_ORB_UI_BACKEND_PORT = int(os.getenv("ORB_UI_BACKEND_PORT", "8001"))
+_ORB_UI_FRONTEND_PORT = int(os.getenv("ORB_UI_FRONTEND_PORT", "3000"))
+
+try:
+    import reflex as rx  # pyright: ignore[reportMissingImports]
+
+    config = rx.Config(
+        # Reflex resolves the app via this dotted module path; it imports
+        # ``orb.ui.app`` and looks for a top-level ``app`` (rx.App instance).
+        # ``app_name`` must match ^[a-zA-Z][a-zA-Z0-9_]*$ (Reflex requirement).
+        # The actual dotted import path is ``app_module_import`` below.
+        app_name="orb_ui",
+        app_module_import="orb.ui.app",
+        backend_port=_ORB_UI_BACKEND_PORT,
+        frontend_port=_ORB_UI_FRONTEND_PORT,
+        plugins=[
+            rx.plugins.SitemapPlugin(),
+            rx.plugins.TailwindV4Plugin(),
+            rx.plugins.RadixThemesPlugin(
+                theme=rx.theme(appearance="light", accent_color="blue", radius="medium"),
+            ),
+        ],
+    )
+except ImportError:
+    # reflex is not installed (CI lane without the [ui] extra, pyright, etc.).
+    # ``config`` is left undefined; this file is only executed at runtime by
+    # ``reflex run`` which requires the [ui] extra to be present.
+    pass