From c9c30563f23d63320e1b57ccf1e645f1e9e930dd Mon Sep 17 00:00:00 2001
From: mptyl <mp@tylconsulting.it>
Date: Fri, 14 Aug 2026 21:20:41 +0200
Subject: [PATCH] fix: improve workspace manager navigation and sizing

---
 frontend/src/shell/WorkspaceManager.test.tsx | 18 +++++++++++++++---
 frontend/src/shell/WorkspaceManager.tsx      | 14 ++++++++++++--
 2 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/frontend/src/shell/WorkspaceManager.test.tsx b/frontend/src/shell/WorkspaceManager.test.tsx
index b9a140ba..f5d0ddd4 100644
--- a/frontend/src/shell/WorkspaceManager.test.tsx
+++ b/frontend/src/shell/WorkspaceManager.test.tsx
@@ -70,15 +70,27 @@ beforeEach(() => {
   );
 });
 
-test("uses at least sixty percent of the viewport on desktop", () => {
+test("uses a tall viewport area and keeps the workspace content scrollable", () => {
   renderManager();
 
-  expect(screen.getByRole("dialog")).toHaveClass(
-    "h-[70vh]",
+  const dialog = screen.getByRole("dialog");
+  expect(dialog).toHaveClass(
+    "h-[86vh]",
     "w-[94vw]",
     "sm:w-[70vw]",
     "max-w-[94vw]",
   );
+  expect(screen.getByRole("main")).toHaveClass("overflow-y-auto");
+});
+
+test("offers an internal link back to the initial page", async () => {
+  const user = userEvent.setup();
+  const onClose = vi.fn();
+  renderManager(onClose);
+
+  await user.click(screen.getByRole("button", { name: "Back to main page" }));
+
+  expect(onClose).toHaveBeenCalledTimes(1);
 });
 
 test("level one explains the read-only Git sequence and the repository update button", async () => {
diff --git a/frontend/src/shell/WorkspaceManager.tsx b/frontend/src/shell/WorkspaceManager.tsx
index 237602c7..62c09a4e 100644
--- a/frontend/src/shell/WorkspaceManager.tsx
+++ b/frontend/src/shell/WorkspaceManager.tsx
@@ -2,6 +2,7 @@ import { useMemo, useState } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import {
   AlertCircle,
+  ArrowLeft,
   CheckCircle2,
   ClipboardCheck,
   FlaskConical,
@@ -214,9 +215,18 @@ export function WorkspaceManager({ open, onClose }: { open: boolean; onClose: ()
     <Dialog open={open} onOpenChange={(nextOpen) => { if (!nextOpen) close(); }}>
       <DialogContent
         showCloseButton={false}
-        className="h-[70vh] w-[94vw] max-h-[90vh] max-w-[94vw] grid-rows-[auto_minmax(0,1fr)] gap-0 overflow-hidden p-0 sm:w-[70vw] sm:max-w-[94vw]"
+        className="h-[86vh] w-[94vw] max-h-[92vh] max-w-[94vw] grid-rows-[auto_minmax(0,1fr)] gap-0 overflow-hidden p-0 sm:w-[70vw] sm:max-w-[94vw]"
       >
         <DialogHeader className="border-b border-border/70 px-6 pb-4 pt-5 pr-12">
+          <Button
+            type="button"
+            size="sm"
+            variant="link"
+            className="w-fit px-0"
+            onClick={close}
+          >
+            <ArrowLeft />Back to main page
+          </Button>
           <DialogTitle>Workspace management</DialogTitle>
           <DialogDescription>
             Read, validate, and complete the runtime configuration of workspaces supplied by the installation repository.
@@ -251,7 +261,7 @@ export function WorkspaceManager({ open, onClose }: { open: boolean; onClose: ()
             </div>
           </nav>
 
-          <main className="min-w-0 overflow-y-auto px-6 py-5">
+          <main className="min-h-0 min-w-0 overflow-y-auto overscroll-contain px-6 py-5">
             {notice && (
               <p role="status" className="mb-4 flex items-center gap-2 rounded-md border border-border bg-muted/50 px-3 py-2 text-sm">
                 <CheckCircle2 className="size-4 text-primary" />{notice}