Updates to support docs frontend path (#6359)

* Updates to support docs frontend path

* just set /docs

Author: carlosabadia

docs/api-reference/event_triggers.md

@@ -266,7 +266,7 @@ def unmount_example():
         rx.text(UnmountState.status),
         rx.link(
             rx.button("Navigate Away (Triggers Unmount)"),
-            href="/docs",
+            href="/",
         ),
         on_mount=UnmountState.initialize_resource,
         on_unmount=UnmountState.on_unmount,

docs/app/README.md

@@ -24,19 +24,19 @@ Markdown docs live in the parent `docs/` directory (one level above `app/`). Edi
 
 By default, the dev server compiles **all** pages, which can be slow. To speed things up, you can whitelist only the pages you're working on so only those get compiled.
 
-Edit `reflex_docs/whitelist.py` and add paths to the `WHITELISTED_PAGES` list:
+Edit `reflex_docs/whitelist.py` and add paths to the `WHITELISTED_PAGES` list. Paths are **app routes** (relative to `frontend_path`, which defaults to `/docs` in `rxconfig.py`). Do not repeat the `/docs` mount segment in the whitelist, or nothing will match.
 
 ```python
 WHITELISTED_PAGES = [
-    "/docs/getting-started/introduction",
-    "/docs/components/props",
+    "/getting-started/introduction",
+    "/components/props",
 ]
 ```
 
 **Rules:**
 - Each path must start with a forward slash `/`.
-- Do **not** include a trailing slash (e.g. `/docs/components/props`, not `/docs/components/props/`).
+- Do **not** include a trailing slash (e.g. `/getting-started/introduction`, not `/getting-started/introduction/`).
 - An empty list (`[]`) builds all pages (the default).
-- Paths are prefix-matched, so `"/docs/components"` will include all pages under that section.
+- Paths are prefix-matched, so `"/components"` will include all pages under that section.
 
 After editing the whitelist, restart the dev server for changes to take effect.

docs/app/reflex_docs/components/docpage/navbar/buttons/sidebar.py

@@ -55,16 +55,18 @@ def drawer_item(text: str, url: str, active_str: str = "") -> rx.Component:
         url += "/"
     active = router_path.contains(active_str)
     if active_str == "docs":
+        is_docs_home = (router_path == "/") | (router_path == "/index")
         active = rx.cond(
-            router_path.contains("hosting")
-            | router_path.contains("library")
-            | router_path.contains("gallery"),
+            is_docs_home,
             False,
-            active,
+            ~router_path.contains("hosting")
+            & ~router_path.contains("library")
+            & ~router_path.contains("gallery")
+            & ~router_path.contains("ai-builder"),
         )
     if active_str == "":
         active = False
-    return rx.link(
+    return rx.el.elements.a(
         text,
         href=url,
         underline="none",

docs/app/reflex_docs/pages/docs/__init__.py

@@ -152,7 +152,14 @@ def doc_title_from_path(doc: str) -> str:
 
 
 def doc_route_from_path(doc: str) -> str:
-    """Compute the URL route from a doc path."""
+    """Compute the URL route from a doc path.
+
+    Virtual paths are rooted at ``docs/`` (the content directory). The site is
+    already served under ``frontend_path`` (e.g. ``/docs``), so the public path
+    must not repeat that segment (``/docs/docs/...``).
+    """
+    doc = doc.replace("\\", "/")
+    doc = doc.removeprefix("docs/")
     route = rx.utils.format.to_kebab_case(f"/{doc.replace('.md', '/')}")
     if route.endswith("/index/"):
         route = route[:-7] + "/"

docs/app/reflex_docs/pages/docs/api_reference/plugins.py

@@ -5,7 +5,7 @@
 from reflex_docs.templates.docpage import docpage
 
 
-@docpage("/docs/api-reference/plugins/")
+@docpage("/api-reference/plugins/")
 def plugins():
     """Plugins API reference page."""
     with open("docs/api-reference/plugins.md", encoding="utf-8") as f:

docs/app/reflex_docs/pages/docs/api_reference/utils.py

@@ -5,7 +5,7 @@
 from reflex_docs.templates.docpage import docpage
 
 
-@docpage("/docs/api-reference/utils/")
+@docpage("/api-reference/utils/")
 def utils():
     """Utils API reference page."""
     with open("docs/api-reference/utils.md", encoding="utf-8") as f:

docs/app/reflex_docs/pages/docs/apiref.py

@@ -39,7 +39,7 @@
     name = module.__name__.lower()
     docs = generate_docs(name, module, extra_fields=extra_fields)
     title = name.replace("_", " ").title()
-    page_data = docpage(f"/docs/api-reference/{name}/", title)(docs)
+    page_data = docpage(f"/api-reference/{name}/", title)(docs)
     page_data.title = page_data.title.split("·")[0].strip()
     pages.append(page_data)
 

docs/app/reflex_docs/pages/docs/cloud_cliref.py

@@ -352,6 +352,6 @@ def generate_docs(source: str):
 for module_name, module_value in modules.items():
     docs = generate_docs(module_value)
     title = module_name.replace("_", " ").title()
-    page_data = docpage(f"/docs/hosting/cli/{module_name}/", title)(docs)
+    page_data = docpage(f"/hosting/cli/{module_name}/", title)(docs)
     page_data.title = page_data.title.split("·")[0].strip()
     pages.append(page_data)

docs/app/reflex_docs/pages/docs/custom_components.py

@@ -403,7 +403,7 @@ def create_pagination():
     )
 
 
-@docpage(right_sidebar=False)
+@docpage(set_path="/custom-components/", right_sidebar=False)
 def custom_components() -> rx.Component:
     return rx.box(
         rx.box(

docs/app/reflex_docs/pages/docs/enterprise.py

@@ -4,7 +4,7 @@
 
 
 @docpage(
-    set_path="/docs/enterprise/overview",
+    set_path="/enterprise/overview",
     t="Overview | Enterprise",
 )
 def overview():