From 1390eadd9289a558da9f76b5cf3e9d97ad1e5952 Mon Sep 17 00:00:00 2001
From: Val Alexander <68980965+BunsDev@users.noreply.github.com>
Date: Wed, 29 Apr 2026 10:27:10 -0500
Subject: [PATCH] fix(control-ui): link dashboard breadcrumb

Make the topbar OpenClaw breadcrumb a semantic Overview link, wire the existing navigate event at the app shell, and preserve prefixed Control UI base paths.\n\nValidation:\n- pnpm test ui/src/ui/navigation.browser.test.ts\n- pnpm exec oxfmt --check --threads=1 ui/src/ui/components/dashboard-header.ts ui/src/ui/app-render.ts ui/src/ui/navigation.browser.test.ts\n- git diff --check origin/main...HEAD
---
 ui/src/styles/layout.css                 | 17 ++++++++++++++
 ui/src/ui/app-render.ts                  | 16 +++++++++++--
 ui/src/ui/components/dashboard-header.ts | 30 ++++++++++++++++++------
 ui/src/ui/navigation.browser.test.ts     | 28 ++++++++++++++++++++++
 4 files changed, 82 insertions(+), 9 deletions(-)

diff --git a/ui/src/styles/layout.css b/ui/src/styles/layout.css
index 08774c6d6e2..3f545eae6cf 100644
--- a/ui/src/styles/layout.css
+++ b/ui/src/styles/layout.css
@@ -160,6 +160,23 @@
   color: var(--muted);
 }
 
+.topnav-shell .dashboard-header__breadcrumb-link {
+  display: inline-flex;
+  align-items: center;
+  margin: -2px -4px;
+  padding: 2px 4px;
+  border-radius: var(--radius-sm);
+  text-decoration: none;
+  white-space: nowrap;
+}
+
+.topnav-shell .dashboard-header__breadcrumb-link:hover,
+.topnav-shell .dashboard-header__breadcrumb-link:focus-visible {
+  color: var(--text);
+  text-decoration: underline;
+  text-underline-offset: 3px;
+}
+
 .topnav-shell .dashboard-header__breadcrumb-current {
   color: var(--accent);
   font-weight: 650;
diff --git a/ui/src/ui/app-render.ts b/ui/src/ui/app-render.ts
index 2680bc202d6..1b2fb4568ef 100644
--- a/ui/src/ui/app-render.ts
+++ b/ui/src/ui/app-render.ts
@@ -117,7 +117,13 @@ import {
 import { buildExternalLinkRel, EXTERNAL_LINK_TARGET } from "./external-link.ts";
 import { icons } from "./icons.ts";
 import { createLazyView, renderLazyView } from "./lazy-view.ts";
-import { normalizeBasePath, TAB_GROUPS, subtitleForTab, titleForTab } from "./navigation.ts";
+import {
+  normalizeBasePath,
+  TAB_GROUPS,
+  subtitleForTab,
+  titleForTab,
+  type Tab,
+} from "./navigation.ts";
 import { isPluginEnabledInConfigSnapshot } from "./plugin-activation.ts";
 import "./components/dashboard-header.ts";
 import {
@@ -1346,7 +1352,13 @@ export function renderApp(state: AppViewState) {
             <span class="nav-collapse-toggle__icon" aria-hidden="true">${icons.menu}</span>
           </button>
           <div class="topnav-shell__content">
-            <dashboard-header .tab=${state.tab}></dashboard-header>
+            <dashboard-header
+              .tab=${state.tab}
+              .basePath=${state.basePath}
+              @navigate=${(event: CustomEvent<Tab>) => {
+                state.setTab(event.detail);
+              }}
+            ></dashboard-header>
           </div>
           <div class="topnav-shell__actions">
             <button
diff --git a/ui/src/ui/components/dashboard-header.ts b/ui/src/ui/components/dashboard-header.ts
index 75110371703..1c2f82a9b76 100644
--- a/ui/src/ui/components/dashboard-header.ts
+++ b/ui/src/ui/components/dashboard-header.ts
@@ -1,6 +1,6 @@
 import { LitElement, html } from "lit";
 import { property } from "lit/decorators.js";
-import { titleForTab, type Tab } from "../navigation.js";
+import { pathForTab, titleForTab, type Tab } from "../navigation.js";
 
 export class DashboardHeader extends LitElement {
   override createRenderRoot() {
@@ -8,6 +8,24 @@ export class DashboardHeader extends LitElement {
   }
 
   @property() tab: Tab = "overview";
+  @property() basePath = "";
+
+  private handleOverviewClick(event: MouseEvent) {
+    if (
+      event.defaultPrevented ||
+      event.button !== 0 ||
+      event.metaKey ||
+      event.ctrlKey ||
+      event.shiftKey ||
+      event.altKey
+    ) {
+      return;
+    }
+    event.preventDefault();
+    this.dispatchEvent(
+      new CustomEvent("navigate", { detail: "overview", bubbles: true, composed: true }),
+    );
+  }
 
   override render() {
     const label = titleForTab(this.tab);
@@ -15,15 +33,13 @@ export class DashboardHeader extends LitElement {
     return html`
       <div class="dashboard-header">
         <div class="dashboard-header__breadcrumb">
-          <span
+          <a
             class="dashboard-header__breadcrumb-link"
-            @click=${() =>
-              this.dispatchEvent(
-                new CustomEvent("navigate", { detail: "overview", bubbles: true, composed: true }),
-              )}
+            href=${pathForTab("overview", this.basePath)}
+            @click=${this.handleOverviewClick}
           >
             OpenClaw
-          </span>
+          </a>
           <span class="dashboard-header__breadcrumb-sep">›</span>
           <span class="dashboard-header__breadcrumb-current">${label}</span>
         </div>
diff --git a/ui/src/ui/navigation.browser.test.ts b/ui/src/ui/navigation.browser.test.ts
index 6ca02d7785b..d281901e807 100644
--- a/ui/src/ui/navigation.browser.test.ts
+++ b/ui/src/ui/navigation.browser.test.ts
@@ -48,6 +48,34 @@ describe("control UI routing", () => {
     expect(dreamsLink).not.toBeNull();
   });
 
+  it("renders the dashboard breadcrumb as an overview link", async () => {
+    const app = mountApp("/channels");
+    await app.updateComplete;
+
+    const breadcrumb = app.querySelector<HTMLAnchorElement>(
+      "dashboard-header .dashboard-header__breadcrumb-link",
+    );
+    expect(breadcrumb).toBeInstanceOf(HTMLAnchorElement);
+    expect(breadcrumb?.getAttribute("href")).toBe("/overview");
+
+    breadcrumb?.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true }));
+    await app.updateComplete;
+
+    expect(app.tab).toBe("overview");
+    expect(window.location.pathname).toBe("/overview");
+  });
+
+  it("keeps the dashboard breadcrumb link inside the configured base path", async () => {
+    const app = mountApp("/ui/channels");
+    await app.updateComplete;
+
+    const breadcrumb = app.querySelector<HTMLAnchorElement>(
+      "dashboard-header .dashboard-header__breadcrumb-link",
+    );
+    expect(breadcrumb).toBeInstanceOf(HTMLAnchorElement);
+    expect(breadcrumb?.getAttribute("href")).toBe("/ui/overview");
+  });
+
   it("renders the dreaming view on the /dreaming route", async () => {
     const app = mountApp("/dreaming");
     app.dreamingStatus = {