From 63f96254e558a16e1928d3168b79b60fbd37f498 Mon Sep 17 00:00:00 2001
From: Matt <matt@letsbe.solutions>
Date: Mon, 11 May 2026 15:08:53 +0200
Subject: [PATCH] fix(documents-hub): scope gradient PageHeader to root view;
 add inline New-document button on folder views
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The gradient "Documents — Track signing status..." banner was rendering on
all three render modes (HubRootView / EntityFolderView / FlatFolderListing),
duplicating the in-empty-state CTA on folder views. Keep it only on the
root landing page; for folder views, surface a compact "+ New document"
button in the upper-right aligned with the FolderBreadcrumb row.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/components/documents/documents-hub.tsx | 33 ++++++++++++++--------
 1 file changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/components/documents/documents-hub.tsx b/src/components/documents/documents-hub.tsx
index bfa1302d..f816d3ba 100644
--- a/src/components/documents/documents-hub.tsx
+++ b/src/components/documents/documents-hub.tsx
@@ -151,24 +151,35 @@ export function DocumentsHub({ portSlug }: DocumentsHubProps) {
         }
       />
       <div className="flex-1 min-w-0 p-4 space-y-4">
-        <FolderBreadcrumb selectedFolderId={selectedFolderId} onSelect={handleFolderSelect} />
-
-        <PageHeader
-          title="Documents"
-          description="Track signing status, chase pending signers, and audit completion."
-          actions={
-            <Button asChild>
+        <div className="flex items-center justify-between gap-3">
+          <FolderBreadcrumb selectedFolderId={selectedFolderId} onSelect={handleFolderSelect} />
+          {selectedFolderId !== undefined && (
+            <Button asChild size="sm">
               <Link href={`/${portSlug}/documents/new`}>
                 <Plus className="mr-1.5 h-4 w-4" />
                 New document
               </Link>
             </Button>
-          }
-          variant="gradient"
-        />
+          )}
+        </div>
 
         {selectedFolderId === undefined ? (
-          <HubRootView portSlug={portSlug} />
+          <>
+            <PageHeader
+              title="Documents"
+              description="Track signing status, chase pending signers, and audit completion."
+              actions={
+                <Button asChild>
+                  <Link href={`/${portSlug}/documents/new`}>
+                    <Plus className="mr-1.5 h-4 w-4" />
+                    New document
+                  </Link>
+                </Button>
+              }
+              variant="gradient"
+            />
+            <HubRootView portSlug={portSlug} />
+          </>
         ) : isEntityFolder && isEntityType(folderEntityType) ? (
           <EntityFolderView
             portSlug={portSlug}