From 05a1d8570ddbd0454a9c1d8c4e4397cea38f1032 Mon Sep 17 00:00:00 2001 From: Algis Dumbris Date: Tue, 25 Aug 2026 14:22:54 +0300 Subject: [PATCH 1/5] fix(webui): give first run a way forward (F3, F19) and keep "what needs me" on the landing page (F4) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Web UI UX audit (docs/qa/ux-audit-webui-2026-08.md), first-run and onboarding. F3 — Servers page, zero servers. The page a new user lands on after closing the wizard said "No servers found / No servers available" and offered nothing to click, above four zero-valued stat tiles, four zero-count filter pills and a search box with nothing to search. It now renders the AgentTokens-style empty state: a headline, one line of why upstream servers matter, Add Server (primary), Browse Registry, and a quiet "Import from your AI client configs" link into the wizard's Servers step. The stat/filter/search chrome is hidden until a server exists, and "you have nothing yet" is now a separate state from "nothing matched your filter" — the two need different answers. F4 residual (after #1044) — #1044 routed /usage, made the analytics panel the default landing page and demoted the hub diagram, which is most of the fix. What it did not carry across is the other half the finding asked for: the landing page still answered "what happened" and not "what needs me". The servers-needing-attention and tools-pending-approval banners were inside the Overview panel, so a fresh landing could render charts while a server was down and an unreviewed tool was waiting, and say neither. They move above the panel switcher: visible on whichever panel is active, silent when there is nothing to act on. F19 — onboarding wizard, Servers step. It was entirely "pick which servers from your existing AI clients to import", so a user with no prior MCP config hit a dead end. Adds a nothing-to-import branch (browse the registry / add a server manually). Import & quarantine becomes the single primary and the unreviewed path becomes a link that says what it skips, "Import without review" — previously two similar primaries with the safer one rendered weaker. The Docker-isolation/quarantine panel is expanded by default and moved out of the sticky footer into the step body, where it can be open without squeezing the list; the import list is capped and scrolls in place instead of clipping its last row; and every step gets a Back. --- frontend/src/components/OnboardingWizard.vue | 297 ++++++++++++------ frontend/src/stores/onboarding.ts | 23 +- frontend/src/views/Dashboard.vue | 178 ++++++----- frontend/src/views/Servers.vue | 94 +++++- .../unit/dashboard-attention-banners.spec.ts | 181 +++++++++++ .../onboarding-wizard-servers-step.spec.ts | 232 ++++++++++++++ .../unit/servers-first-run-empty.spec.ts | 188 +++++++++++ 7 files changed, 1000 insertions(+), 193 deletions(-) create mode 100644 frontend/tests/unit/dashboard-attention-banners.spec.ts create mode 100644 frontend/tests/unit/onboarding-wizard-servers-step.spec.ts create mode 100644 frontend/tests/unit/servers-first-run-empty.spec.ts diff --git a/frontend/src/components/OnboardingWizard.vue b/frontend/src/components/OnboardingWizard.vue index 24b51ea8a..70aa108de 100644 --- a/frontend/src/components/OnboardingWizard.vue +++ b/frontend/src/components/OnboardingWizard.vue @@ -200,10 +200,48 @@
-
- No client configs with importable servers detected on this machine. + +
+
📦
+
Nothing to import
+

+ We found no MCP servers in your AI clients' configs on this machine — + so there is nothing to bring across. Start from the registry instead, + or add a server yourself. +

+
+ + +
+

+ ✓ Server added — it's currently in quarantine. Review it on the Servers page after this wizard. +

-
+ +
{{ selectionImportMessage }}
-
+ +
+ + ▸ + Runtime isolation and MCP server quarantine + + Global settings + + + +
+ + + + + +
+
+ + +
▸ Add a single server manually instead @@ -383,111 +501,44 @@
- +
-
- - ▸ - Runtime isolation and MCP server quarantine - - Global settings - - - -
- - - - - -
-
- - -
-
- Select at least one server to import - - {{ selectedCount }} - selected - - · {{ conflictCount }} renamed + +
+
+ +
+ Select at least one server to import + + {{ selectedCount }} + selected + + · {{ conflictCount }} renamed + - +
-
- + +
+ +
+ + +
- +
-
- Tip: you can always re-open this from the sidebar's Setup entry. +
+ +
+ Tip: you can always re-open this from the sidebar's Setup entry. +