solara 1.29.0__py2.py3-none-any.whl → 1.30.0__py2.py3-none-any.whl

solara/website/components/docs.py

@@ -0,0 +1,118 @@
+import solara
+from solara.alias import rv
+
+
+@solara.component
+def Gallery(route_external=None):
+    if route_external is not None:
+        route_current = route_external
+    else:
+        # show a gallery of all the examples
+        router = solara.use_router()
+        route_current = router.path_routes[-2]
+
+    with solara.Column(gap="75px", align="center"):
+        with solara.Row(justify="center", gap="30px", style={"margin": "30px 0 !important", "flex-wrap": "wrap", "align-items": "start", "row-gap": "30px"}):
+            for child in route_current.children:
+                if child.path == "/":
+                    continue
+                with solara.v.Html(tag="a", attributes={"href": "#" + child.path}):
+                    solara.Button(
+                        child.label,
+                        color="primary",
+                        classes=["v-btn--rounded", "v-size--x-large"],
+                    )
+
+        with solara.Column(gap="75px", style={"padding-bottom": "75px"}):
+            for route in route_current.children:
+                if route.children:
+                    with solara.Column(classes=["subcategory-row", "ps-md-10"]):
+                        solara.HTML(tag="h2", unsafe_innerHTML=route.label, attributes={"id": route.path}, style="padding-left: 10%;")
+                        with solara.Row(justify="center", gap="20px", style={"flex-wrap": "wrap", "row-gap": "20px", "max-width": "90rem"}):
+                            for child in route.children:
+                                if child.path == "/":
+                                    continue
+                                path = route.path + "/" + child.path
+                                if child.path in [
+                                    "button",
+                                    "checkbox",
+                                    "confirmation_dialog",
+                                    "echarts",
+                                    "file_browser",
+                                    "file_download",
+                                    "matplotlib",
+                                    "select",
+                                    "switch",
+                                    "tooltip",
+                                ]:
+                                    image_url = "https://dxhl76zpt6fap.cloudfront.net/public/api/" + child.path + ".gif"
+                                elif child.path in ["card", "dataframe", "pivot_table", "slider"]:
+                                    image_url = "https://dxhl76zpt6fap.cloudfront.net/public/api/" + child.path + ".png"
+                                else:
+                                    image_url = "https://dxhl76zpt6fap.cloudfront.net/public/logo.svg"
+
+                                if path:
+                                    path = path if route_external is None else route_current.path + "/" + path
+                                    title = solara.Link(path, children=[child.label])
+                                    with solara.Card(title, classes=["component-card"], margin=0):
+                                        with solara.Column(align="center"):
+                                            with solara.Link(path):
+                                                solara.Image(image_url, width="12rem")
+
+
+@solara.component
+def NoPage():
+    raise RuntimeError("This page should not be rendered")
+
+
+@solara.component
+def WithCode(module):
+    component = getattr(module, "Page", None)
+    with rv.Sheet() as main:
+        # It renders code better
+        solara.Markdown(
+            module.__doc__ or "# no docs yet",
+            unsafe_solara_execute=True,
+        )
+        if component and component != NoPage:
+            with solara.Card("Example", margin=0, classes=["mt-8"]):
+                component()
+                github_url = solara.util.github_url(module.__file__)
+                solara.Button(
+                    label="View source",
+                    icon_name="mdi-github-circle",
+                    attributes={"href": github_url, "target": "_blank"},
+                    text=True,
+                    outlined=True,
+                    class_="mt-8",
+                )
+    return main
+
+
+@solara.component
+def SubCategoryLayout(children=[]):
+    route_current, all_routes = solara.use_route()
+    if route_current is None:
+        return solara.Error("Page not found")
+    elif route_current.path == "/":
+        return solara.Error("Not supposed to be rendered")
+    elif route_current.module:
+        WithCode(route_current.module)
+    else:
+        with solara.Column(align="center", children=children, style={"flex-grow": 1, "padding": "0"}) as main:
+            pass
+        return main
+
+
+@solara.component
+def CategoryLayout(children=[]):
+    route_current, all_routes = solara.use_route()
+    if route_current is None:
+        return solara.Error("Page not found")
+
+    if route_current.path == "/":
+        return Gallery()
+    else:
+        with solara.Column(align="stretch", style={"width": "1024px", "flex-grow": 1}, children=children) as main:
+            pass
+        return main

solara/website/components/header.py

@@ -6,8 +6,8 @@ from solara.alias import rv
 from solara.server import settings
 
 
-@solara._component_vue("algolia.vue")
-def Algolia(app_id: str, index_name: str, api_key: str, debug=False):
+@solara.component_vue("algolia_api.vue")
+def Algolia():
     pass
 
 
@@ -18,6 +18,7 @@ def Header(
 ):
     # use routes of parent (assuming we are a child of a layout)
     route_current, all_routes = solara.use_route(level=-1)
+    route_current_with_children, all_routes_with_children = solara.use_route()
     router = solara.use_router()
     dark_effective = solara.lab.use_dark_effective()
 
@@ -28,7 +29,7 @@ def Header(
                 "div",
                 unsafe_innerHTML="<a href='https://github.com/widgetti/solara' target='_blank' >Star us on github 🤩</a>",
             )
-        with rv.AppBar(tag="header", flat=True, class_="bg-primary-fade padding-40", height="auto"):
+        with solara.v.AppBar(tag="header", flat=True, class_="bg-primary-fade padding-40", height="auto", clipped_left=True):
             with rv.ToolbarTitle(class_="d-flex", style_="align-items:center"):
                 if route_current and len(route_current.children) > 0:
                     with solara.Button(icon=True, class_="hidden-md-and-up", on_click=lambda: on_toggle_left_menu and on_toggle_left_menu()):
@@ -37,15 +38,24 @@ def Header(
                     solara.Image(router.root_path + f"/static/assets/images/logo{'_white' if dark_effective else ''}.svg")
             rv.Spacer()
 
-            if settings.search.enabled:
-                from solara_enterprise.search.search import Search
+            if (
+                route_current_with_children is not None
+                and route_current is not None
+                and route_current.path == "documentation"
+                and route_current_with_children.path == "/"
+            ):
+                solara.v.Spacer()
+            else:
+                if settings.search.enabled:
+                    from solara_enterprise.search.search import Search
 
-                Search()
-            Algolia(app_id="9KW9L7O5EQ", api_key="ef7495102afff1e16d1b7cf6ec2ab2d0", index_name="solara", debug=True)
-            # menu
+                    Search()
+                else:
+                    with solara.Row(justify="end", style={"align-items": "center", "flex-grow": "1", "background-color": "transparent"}):
+                        Algolia()
             with rv.Html(tag="ul", class_="main-menu menu d-none d-md-flex"):
                 for route in all_routes:
-                    if route.path == "apps":
+                    if route.path in ["apps", "contact", "changelog"]:
                         continue
                     current = route_current == route
                     with rv.Html(tag="li", class_="active" if current else None):
@@ -53,7 +63,7 @@ def Header(
             with rv.Btn(icon=True, tag="a", class_="d-none d-md-flex", attributes={"href": solara.github_url, "target": "_blank"}):
                 rv.Icon(children=["mdi-github-circle"])
 
-            with rv.Btn(icon=True, tag="a", class_="d-none d-md-flex", attributes={"href": "https://discord.gg/dm4GKNDjXN", "target": "_blank"}):
+            with rv.Btn(icon=True, tag="a", class_="d-none d-md-flex", attributes={"href": "https://discord.solara.dev", "target": "_blank"}):
                 rv.Icon(children=["mdi-discord"])
 
             solara.lab.ThemeToggle()

solara/website/components/hero.py

@@ -10,6 +10,6 @@ def Hero(title, sub_title, button_text):
                 with rv.Col(md=8, offset_md=2, sm=10, offset_sm=1):
                     rv.Html(tag="h1", children=[title], class_="mb-4"),
                     solara.HTML(tag="div", unsafe_innerHTML=f"<h2>{sub_title}</h2>", class_="mb-4"),
-                    with solara.Link("/docs/quickstart"):
+                    with solara.Link("/documentation/getting_started"):
                         solara.Button(label=button_text, elevation=0, large=True, class_="btn-size--xlarge solara-docs-button")
     return main

solara/website/pages/__init__.py

@@ -3,13 +3,208 @@ import contextlib
 import solara
 from solara.alias import rv
 from solara.components.title import Title
+from solara.server import server
 
 from ..components import Header, Hero
 from ..components.mailchimp import MailChimp
 
 title = "Home"
 
-route_order = ["/", "showcase", "docs", "api", "examples", "apps"]
+route_order = ["/", "showcase", "documentation", "apps", "contact", "changelog"]
+
+
+server._redirects = {
+    "/docs": "/documentation/getting_started/introduction",
+    "/docs/installing": "/documentation/getting_started/installing",
+    "/docs/quickstart": "/documentation/getting_started",
+    "/docs/tutorial": "/documentation/getting_started/tutorials",
+    "/docs/tutorial/data-science": "/documentation/getting_started/tutorials/data-science",
+    "/docs/tutorial/web-app": "/documentation/getting_started/tutorials/web-app",
+    "/docs/tutorial/ipywidgets": "/documentation/getting_started/tutorials/ipywidgets",
+    "/docs/tutorial/streamlit": "/documentation/getting_started/tutorials/streamlit",
+    "/docs/tutorial/dash": "/documentation/getting_started/tutorials/dash",
+    "/docs/tutorial/jupyter-dashboard-part1": "/documentation/getting_started/tutorials/jupyter-dashboard-part1",
+    "/docs/fundamentals": "/documentation/getting_started/fundamentals",
+    "/docs/fundamentals/components": "/documentation/getting_started/fundamentals/components",
+    "/docs/fundamentals/state-management": "/documentation/getting_started/fundamentals/state-management",
+    "/docs/howto": "/documentation/advanced/howto",
+    "/docs/howto/contribute": "/documentation/advanced/development/contribute",
+    "/docs/howto/multipage": "/documentation/advanced/howto/multipage",
+    "/docs/howto/layout": "/documentation/advanced/howto/layout",
+    "/docs/howto/testing": "/documentation/advanced/howto/testing",
+    "/docs/howto/debugging": "/documentation/advanced/howto/debugging",
+    "/docs/howto/embed": "/documentation/advanced/howto/embed",
+    "/docs/howto/ipywidget-libraries": "/documentation/advanced/howto/ipywidget-libraries",
+    "/docs/reference": "/documentation/getting_started/reference",
+    "/docs/reference/static-files": "/documentation/getting_started/reference/static-files",
+    "/docs/reference/asset-files": "/documentation/getting_started/reference/asset-files",
+    "/docs/reference/static-site-generation": "/documentation/getting_started/reference/static-site-generation",
+    "/docs/reference/search": "/documentation/getting_started/reference/search",
+    "/docs/reference/reloading": "/documentation/getting_started/reference/reloading",
+    "/docs/reference/notebook-support": "/documentation/getting_started/reference/notebook-support",
+    "/docs/reference/caching": "/documentation/getting_started/reference/caching",
+    "/docs/understanding": "/documentation/advanced/understanding",
+    "/docs/understanding/ipywidgets": "/documentation/advanced/understanding/ipywidgets",
+    "/docs/understanding/ipyvuetify": "/documentation/advanced/understanding/ipyvuetify",
+    "/docs/understanding/reacton": "/documentation/advanced/understanding/reacton",
+    "/docs/understanding/reacton-basics": "/documentation/advanced/understanding/reacton-basics",
+    "/docs/understanding/anatomy": "/documentation/advanced/understanding/anatomy",
+    "/docs/understanding/rules-of-hooks": "/documentation/advanced/understanding/rules-of-hooks",
+    "/docs/understanding/containers": "/documentation/advanced/understanding/containers",
+    "/docs/understanding/solara": "/documentation/advanced/understanding/solara",
+    "/docs/understanding/routing": "/documentation/advanced/understanding/routing",
+    "/docs/understanding/solara-server": "/documentation/advanced/understanding/solara-server",
+    "/docs/understanding/voila": "/documentation/advanced/understanding/voila",
+    "/docs/deploying": "/documentation/getting_started/deploying",
+    "/docs/deploying/self-hosted": "/documentation/getting_started/deploying/self-hosted",
+    "/docs/deploying/cloud-hosted": "/documentation/getting_started/deploying/cloud-hosted",
+    "/docs/enterprise": "/documentation/advanced/enterprise",
+    "/docs/enterprise/oauth": "/documentation/advanced/enterprise/oauth",
+    "/docs/development": "/documentation/advanced/development/setup",
+    "/docs/troubleshoot": "/documentation/getting_started/troubleshoot",
+    "/docs/changelog": "/changelog",
+    "/docs/contact": "/contact",
+    "/docs/faq": "/documentation/faq",
+    "/docs/lab": "/documentation/getting_started/lab",
+    "/api": "/documentation/api",
+    "/api/altair": "/documentation/components/viz/altair",
+    "/api/app_bar": "/documentation/components/layout/app_bar",
+    "/api/app_bar_title": "/documentation/components/layout/app_bar_title",
+    "/api/app_layout": "/documentation/components/layout/app_layout",
+    "/api/avatar": "/documentation/components/enterprise/avatar",
+    "/api/avatar_menu": "/documentation/components/enterprise/avatar_menu",
+    "/api/card": "/documentation/components/layout/card",
+    "/api/card_actions": "/documentation/components/layout/card_actions",
+    "/api/column": "/documentation/components/layout/column",
+    "/api/columns": "/documentation/components/layout/columns",
+    "/api/columns_responsive": "/documentation/components/layout/columns_responsive",
+    "/api/cross_filter_dataframe": "/documentation/api/cross_filter/cross_filter_dataframe",
+    "/api/cross_filter_report": "/documentation/api/cross_filter/cross_filter_report",
+    "/api/cross_filter_select": "/documentation/api/cross_filter/cross_filter_select",
+    "/api/cross_filter_slider": "/documentation/api/cross_filter/cross_filter_slider",
+    "/api/generate_routes": "/documentation/api/routing/generate_routes",
+    "/api/generate_routes_directory": "/documentation/api/routing/generate_routes_directory",
+    "/api/resolve_path": "/documentation/api/routing/resolve_path",
+    "/api/resolve_path/kiwi": "/documentation/api/routing/resolve_path/kiwi",
+    "/api/resolve_path/banana": "/documentation/api/routing/resolve_path/banana",
+    "/api/resolve_path/apple": "/documentation/api/routing/resolve_path/apple",
+    "/api/link": "/documentation/components/advanced/link",
+    "/api/link/kiwi": "/documentation/components/advanced/link/kiwi",
+    "/api/link/banana": "/documentation/components/advanced/link/banana",
+    "/api/link/apple": "/documentation/components/advanced/link/apple",
+    "/api/use_route": "/documentation/api/routing/use_route",
+    "/api/use_route/fruit": "/documentation/api/routing/use_route/fruit",
+    "/api/use_route/fruit/kiwi": "/documentation/api/routing/use_route/fruit/kiwi",
+    "/api/use_route/fruit/banana": "/documentation/api/routing/use_route/fruit/banana",
+    "/api/use_route/fruit/apple": "/documentation/api/routing/use_route/fruit/apple",
+    "/api/use_router": "/documentation/api/routing/use_router",
+    "/api/use_cross_filter": "/documentation/api/hooks/use_cross_filter",
+    "/api/use_dark_effective": "/documentation/api/hooks/use_dark_effective",
+    "/api/use_effect": "/documentation/api/hooks/use_effect",
+    "/api/use_exception": "/documentation/api/hooks/use_exception",
+    "/api/use_memo": "/documentation/api/hooks/use_memo",
+    "/api/use_previous": "/documentation/api/hooks/use_previous",
+    "/api/use_reactive": "/documentation/api/hooks/use_reactive",
+    "/api/use_state": "/documentation/api/hooks/use_state",
+    "/api/use_state_or_update": "/documentation/api/hooks/use_state_or_update",
+    "/api/use_task": "/documentation/components/lab/use_task",
+    "/api/use_thread": "/documentation/api/hooks/use_thread",
+    "/api/use_trait_observe": "/documentation/api/hooks/use_trait_observe",
+    "/examples/fullscreen": "/documentation/examples/fullscreen",
+    "/examples/fullscreen/authorization": "/documentation/examples/fullscreen/authorization",
+    "/examples/fullscreen/layout_demo": "/documentation/examples/fullscreen/layout_demo",
+    "/examples/fullscreen/multipage": "/documentation/examples/fullscreen/multipage",
+    "/examples/fullscreen/scatter": "/documentation/examples/fullscreen/scatter",
+    "/examples/fullscreen/scrolling": "/documentation/examples/fullscreen/scrolling",
+    "/examples/fullscreen/tutorial_streamlit": "/documentation/examples/fullscreen/tutorial_streamlit",
+    "/api/route": "/documentation/api/routing/route",
+    "/api/route/kiwi": "/documentation/api/routing/route/kiwi",
+    "/api/route/banana": "/documentation/api/routing/route/banana",
+    "/api/route/apple": "/documentation/api/routing/route/apple",
+    "/examples/libraries": "/documentation/examples/libraries",
+    "/examples/libraries/altair": "/documentation/examples/libraries/altair",
+    "/examples/libraries/bqplot": "/documentation/examples/libraries/bqplot",
+    "/examples/libraries/ipyleaflet": "/documentation/examples/libraries/ipyleaflet",
+    "/examples/libraries/ipyleaflet_advanced": "/documentation/examples/libraries/ipyleaflet_advanced",
+    "/examples/utilities": "/documentation/examples/utilities",
+    "/examples/utilities/calculator": "/documentation/examples/utilities/calculator",
+    "/examples/utilities/countdown_timer": "/documentation/examples/utilities/countdown_timer",
+    "/examples/utilities/todo": "/documentation/examples/utilities/todo",
+    "/examples/visualization": "/documentation/examples/visualization",
+    "/examples/visualization/annotator": "/documentation/examples/visualization/annotator",
+    "/examples/visualization/linked_views": "/documentation/examples/visualization/linked_views",
+    "/examples/visualization/plotly": "/documentation/examples/visualization/plotly",
+    "/examples/general": "/documentation/examples/general",
+    "/examples/general/custom_storage": "/documentation/examples/general/custom_storage",
+    "/examples/general/deploy_model": "/documentation/examples/general/deploy_model",
+    "/examples/general/live_update": "/documentation/examples/general/live_update",
+    "/examples/general/login_oauth": "/documentation/examples/general/login_oauth",
+    "/examples/general/pokemon_search": "/documentation/examples/general/pokemon_search",
+    "/examples/general/vue_component": "/documentation/examples/general/vue_component",
+    "/examples": "/documentation/examples",
+    "/examples/ai": "/documentation/examples/ai",
+    "/examples/ai/chatbot": "/documentation/examples/ai/chatbot",
+    "/examples/ai/tokenizer": "/documentation/examples/ai/tokenizer",
+    "/examples/basics": "/documentation/examples/basics",
+    "/examples/basics/sine": "/documentation/examples/basics/sine",
+    "/api/get_kernel_id": "/documentation/api/utilities/get_kernel_id",
+    "/api/get_session_id": "/documentation/api/utilities/get_session_id",
+    "/api/on_kernel_start": "/documentation/api/utilities/on_kernel_start",
+    "/api/component_vue": "/documentation/api/utilities/component_vue",
+    "/api/plotly": "/documentation/components/viz/plotly",
+    "/api/plotly_express": "/documentation/components/viz/plotly_express",
+    "/api/tab": "/documentation/components/lab/tab",
+    "/api/tabs": "/documentation/components/lab/tabs",
+    "/api/task": "/documentation/components/lab/task",
+    "/api/computed": "/documentation/api/utilities/computed",
+    "/api/markdown": "/documentation/components/output/markdown",
+    "/api/markdown_editor": "/documentation/components/output/markdown_editor",
+    "/api/matplotlib": "/documentation/components/viz/matplotlib",
+    "/api/echarts": "/documentation/components/viz/echarts",
+    "/api/theming": "/documentation/components/lab/theming",
+    "/api/griddraggable": "/documentation/components/layout/griddraggable",
+    "/api/gridfixed": "/documentation/components/layout/gridfixed",
+    "/api/html": "/documentation/components/output/html",
+    "/api/file_download": "/documentation/components/output/file_download",
+    "/api/hbox": "/documentation/components/layout/hbox",
+    "/api/vbox": "/documentation/components/layout/vbox",
+    "/api/sidebar": "/documentation/components/layout/sidebar",
+    "/api/row": "/documentation/components/layout/row",
+    "/api/error": "/documentation/components/status/error",
+    "/api/info": "/documentation/components/status/info",
+    "/api/progress": "/documentation/components/status/progress",
+    "/api/spinner": "/documentation/components/status/spinner",
+    "/api/success": "/documentation/components/status/success",
+    "/api/warning": "/documentation/components/status/warning",
+    "/api/image": "/documentation/components/output/image",
+    "/api/sql_code": "/documentation/components/output/sql_code",
+    "/api/tooltip": "/documentation/components/output/tooltip",
+    "/api/chat": "/documentation/components/lab/chat",
+    "/api/confirmation_dialog": "/documentation/components/lab/confirmation_dialog",
+    "/api/cookies_headers": "/documentation/components/lab/cookies_headers",
+    "/api/input_date": "/documentation/components/lab/input_date",
+    "/api/button": "/documentation/components/input/button",
+    "/api/checkbox": "/documentation/components/input/checkbox",
+    "/api/file_browser": "/documentation/components/input/file_browser",
+    "/api/file_drop": "/documentation/components/input/file_drop",
+    "/api/meta": "/documentation/components/advanced/meta",
+    "/api/style": "/documentation/components/advanced/style",
+    "/api/menu": "/documentation/components/lab/menu",
+    "/api/head": "/documentation/components/page/head",
+    "/api/input": "/documentation/components/input/input",
+    "/api/select": "/documentation/components/input/select",
+    "/api/slider": "/documentation/components/input/slider",
+    "/api/switch": "/documentation/components/input/switch",
+    "/api/togglebuttons": "/documentation/components/input/togglebuttons",
+    "/api/dataframe": "/documentation/components/data/dataframe",
+    "/api/pivot_table": "/documentation/components/data/pivot_table",
+    "/api/display": "/documentation/api/utilities/display",
+    "/api/memoize": "/documentation/api/utilities/memoize",
+    "/api/reactive": "/documentation/api/utilities/reactive",
+    "/api/widget": "/documentation/api/utilities/widget",
+    "/api/default_layout": "/documentation/components/layout",
+    "/api/title": "/documentation/components/page/title",
+}
 
 
 @solara.component
@@ -96,8 +291,10 @@ def Layout(children=[]):
                 button_text="Quickstart",
             )
 
-        with rv.Container(tag="section", fluid=True, ma_0=True, pa_0=True, class_="fill-height mb-8 solara-content-main"):
-            if route_current is not None and route_current.path == "/":
+        with rv.Container(tag="section", fluid=True, ma_0=True, pa_0=True, class_="fill-height solara-content-main"):
+            if route_current is None:
+                return solara.Error("Page not found")
+            elif route_current.path == "/":
                 description = "Use ipywidgets with Solara to build powerful and scalable web apps for Jupyter and production in Python."
                 # both tags in one
                 solara.Meta(name="description", property="og:description", content=description)
@@ -123,9 +320,9 @@ def Layout(children=[]):
                         """
                         )
                         with solara.HBox():
-                            with solara.Link("/docs"):
-                                solara.Button(label="Read more", class_="ma-1 homepage-button", href="/docs", color="primary", dark=True)
-                            with solara.Link("/docs/quickstart"):
+                            with solara.Link("/documentation"):
+                                solara.Button(label="Read more", class_="ma-1 homepage-button", href="/documentation", color="primary", dark=True)
+                            with solara.Link("/documentation/getting_started"):
                                 solara.Button(label="Quickstart", class_="ma-1 homepage-button", color="primary", dark=True)
                     # with rv.Col(md=4, sm=5):
                     #     rv.Img(src="https://dxhl76zpt6fap.cloudfront.net/public/landing/what.webp", style_="width:900px")
@@ -181,7 +378,7 @@ def Layout(children=[]):
                                 text=True,
                                 outlined=False,
                             )
-                            with solara.Link("/examples"):
+                            with solara.Link("/documentation/examples"):
                                 with solara.Column(style="width: 100%;"):
                                     solara.Button(
                                         label="More examples",
@@ -197,7 +394,7 @@ def Layout(children=[]):
                                     In Jupyter or standalone, and run them in production
                                     using FastAPI or starlette.
 
-                                    Get more inspiration from our [examples](/examples).
+                                    Get more inspiration from our [examples](/documentation/examples).
                                 """
                             )
                             with rv.ExpansionPanels(v_model=target, on_v_model=set_target, mandatory=True, flat=True):
@@ -209,7 +406,8 @@ def Layout(children=[]):
                                     rv.ExpansionPanelHeader(children=["FastAPI"])
                                     with rv.ExpansionPanelContent():
                                         solara.Markdown(
-                                            "Using [solara-server](/docs/understanding/solara-server), we can run our app in production using FastAPI."
+                                            """Using [solara-server](documentation/advanced/understanding/solara-server),
+                                            we can run our app in production using FastAPI."""
                                         )
 
                 with solara.Column(style={"width": "100%"}):
@@ -262,26 +460,32 @@ def Layout(children=[]):
                         solara.Markdown("#### Join our Mailing list to get the latest news")
                         with solara.Div(style={"width": "80%"}):
                             MailChimp(location=router.path)
-
             else:
                 with rv.Row(
-                    style_="gap:6rem; flex-wrap: nowrap;", justify="center" if route_current is not None and route_current.path == "showcase" else "start"
+                    style_="flex-wrap: nowrap; margin: 0; min-height: calc(100vh - 215.5px);",
+                    justify="center" if route_current is not None and route_current.path in ["documentation", "showcase"] else "start",
                 ):
                     if route_current is not None and hasattr(route_current.module, "Sidebar"):
                         route_current.module.Sidebar()  # type: ignore
                     else:
-                        if route_current is not None and route_current.path != "showcase":
+                        if route_current is not None and route_current.path not in ["documentation", "showcase", "contact", "changelog"]:
                             Sidebar()
-                    with rv.Col(tag="main", md=True, class_="pt-12 pl-12 pr-10", style_="max-width: 1024px; overflow: auto;"):
+                    with rv.Col(
+                        tag="main",
+                        md=True,
+                        class_="pa-0",
+                        style_=f"""max-width: {'1024px' if route_current.path not in ['documentation', 'contact', 'changelog']
+                                               else 'unset'}; overflow: hidden auto;""",
+                    ):
                         if route_current is not None and route_current.path == "/":
                             with rv.Row(align="center"):
                                 pass
-                                # with rv.Col(md=6, class_="pa-0"):
-                                #     rv.Html(tag="h1", children=["Live Demo"])
-                                # with rv.Col(md=6, class_="d-flex", style_="justify-content: end"):
-                                #     rv.Btn(elevation=0, large=True, children=["Running App"], color="primary", class_="btn-size--xlarge")
-                            # solara.Padding(6)
-                        with rv.Row(children=children, class_="solara-page-content-search"):
+                        with solara.Row(
+                            children=children,
+                            justify="center",
+                            classes=["solara-page-content-search"],
+                            style=f"height: {'100%' if route_current.path == 'documentation' else 'unset'};",
+                        ):
                             pass
 
             # absolute = True prevents the drawer from being below the overlay it generates
@@ -344,7 +548,6 @@ def Testimonial(text, name, position, img):
         max_width=max_width,
         class_="testimonial-card",
     ):
-        # rv.CardTitle(children=["Former Plotly CEO"])
         with rv.CardActions():
             with rv.ListItem(class_="grow"):
                 with rv.ListItemAvatar(color="grey darken-3"):

solara/website/pages/apps/jupyter-dashboard-1.py

@@ -14,7 +14,7 @@ categories = solara.reactive(["Vandalism", "Assault", "Robbery"])
 limit = solara.reactive(100)
 
 
-ROOT = Path(solara.__file__).parent / "website" / "pages" / "docs" / "content" / "04-tutorial"
+ROOT = Path(solara.__file__).parent / "website" / "pages" / "documentation" / "getting_started" / "content" / "04-tutorials"
 path = ROOT / Path("SF_crime_sample.csv.gz")
 url = "https://raw.githubusercontent.com/widgetti/solara/master/solara/website/pages/docs/content/04-tutorial/SF_crime_sample.csv"
 

solara/website/pages/apps/multipage/__init__.py

@@ -12,7 +12,7 @@ def SharedComponent():
             f"""
             This component will be used on each page.
 
-            It uses the `app_state` [reactive variable](https://solara.dev/api/reactive)
+            It uses the `app_state` [reactive variable](https://solara.dev/documentation/api/utilities/reactive)
             so that the state outlives each page
 
 

solara/website/pages/apps/multipage/page2.py

@@ -23,7 +23,7 @@ def Page():
                 It creates the `component_state` [using the use_reactive hook](https://solara.dev/api/use_reactive)
                 so that the state is bound to the component.
 
-                See also [about state management](https://solara.dev/docs/fundamentals/state-management) for more information.
+                See also [about state management](https://solara.dev/documentation/getting_started/fundamentals/state-management) for more information.
 
 
                 component_state: {component_state.value}

solara/website/pages/apps/scatter.py

@@ -1,3 +1,5 @@
+import pathlib
+import sys
 from typing import Optional, cast
 
 import pandas as pd
@@ -9,11 +11,11 @@ from solara.components.columns import Columns
 from solara.components.file_drop import FileDrop
 
 github_url = solara.util.github_url(__file__)
-try:
-    # fails on pyodide
-    df_sample = pd.read_csv("https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv")
-except:  # noqa
-    df_sample = None
+if sys.platform != "emscripten":
+    pycafe_url = solara.util.pycafe_url(path=pathlib.Path(__file__), requirements=["solara", "pandas", "plotly"])
+else:
+    pycafe_url = None
+df_sample = pd.read_csv("https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv")
 
 
 class State:
@@ -72,7 +74,10 @@ def Page():
                 with solara.Row():
                     solara.Button("Sample dataset", color="primary", text=True, outlined=True, on_click=State.load_sample, disabled=df is not None)
                     solara.Button("Clear dataset", color="primary", text=True, outlined=True, on_click=State.reset)
-                FileDrop(on_file=State.load_from_file, on_total_progress=lambda *args: None, label="Drag file here")
+                if sys.platform != "emscripten":
+                    FileDrop(on_file=State.load_from_file, on_total_progress=lambda *args: None, label="Drag file here")
+                else:
+                    solara.Info("File upload not supported in this environment")
 
                 if df is not None:
                     solara.SliderFloat(label="Size", value=State.size_max, min=1, max=100)
@@ -112,7 +117,16 @@ def Page():
     else:
         solara.Info("No data loaded, click on the sample dataset button to load a sample dataset, or upload a file.")
 
-    solara.Button(label="View source", icon_name="mdi-github-circle", attributes={"href": github_url, "target": "_blank"}, text=True, outlined=True)
+    with solara.Column(style={"max-width": "400px"}):
+        solara.Button(label="View source", icon_name="mdi-github-circle", attributes={"href": github_url, "target": "_blank"}, text=True, outlined=True)
+        if sys.platform != "emscripten":
+            solara.Button(
+                label="Edit this example live on py.cafe",
+                icon_name="mdi-coffee-to-go-outline",
+                attributes={"href": pycafe_url, "target": "_blank"},
+                text=True,
+                outlined=True,
+            )
 
 
 @solara.component

solara/website/pages/changelog/__init__.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+import solara
+
+title = "Changelog"
+HERE = Path(__file__)
+
+Page = solara.Markdown(Path(HERE.parent / "changelog.md").read_text())