From 4a3a8241c31df2542d92487509d69f2021b4fc3d Mon Sep 17 00:00:00 2001
From: Nicholas Cunningham <ndcunningham@gmail.com>
Date: Thu, 27 Mar 2025 15:19:07 -0600
Subject: [PATCH] fix(nx-dev): add data-document attribute to improve search
 (#30524)

---
 nx-dev/ui-cloud/src/lib/layout.tsx            |  4 +++-
 nx-dev/ui-common/src/lib/default-layout.tsx   |  5 ++++-
 .../src/lib/headers/documentation-header.tsx  | 12 +++++++++--
 nx-dev/ui-common/src/lib/headers/header.tsx   | 21 +++++++++++++++++--
 nx-dev/ui-company/src/lib/layout.tsx          |  4 +++-
 .../src/lib/enterprise-layout.tsx             |  2 +-
 6 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/nx-dev/ui-cloud/src/lib/layout.tsx b/nx-dev/ui-cloud/src/lib/layout.tsx
index ce102b8346..7ce4103dd8 100644
--- a/nx-dev/ui-cloud/src/lib/layout.tsx
+++ b/nx-dev/ui-cloud/src/lib/layout.tsx
@@ -18,7 +18,9 @@ export function Layout({
             }}
           />
         </div>
-        <main className="py-24 sm:py-32">{children}</main>
+        <main className="py-24 sm:py-32" data-document="main">
+          {children}
+        </main>
       </div>
     </div>
   );
diff --git a/nx-dev/ui-common/src/lib/default-layout.tsx b/nx-dev/ui-common/src/lib/default-layout.tsx
index 0f18df85cf..baf7fe42ca 100644
--- a/nx-dev/ui-common/src/lib/default-layout.tsx
+++ b/nx-dev/ui-common/src/lib/default-layout.tsx
@@ -31,7 +31,10 @@ export function DefaultLayout({
             }}
           />
         </div>
-        <main className={isHome || hideHeader ? '' : 'py-24 sm:py-32'}>
+        <main
+          data-document="main"
+          className={isHome || hideHeader ? '' : 'py-24 sm:py-32'}
+        >
           {children}
         </main>
       </div>
diff --git a/nx-dev/ui-common/src/lib/headers/documentation-header.tsx b/nx-dev/ui-common/src/lib/headers/documentation-header.tsx
index 633dda1439..59148dd4a2 100644
--- a/nx-dev/ui-common/src/lib/headers/documentation-header.tsx
+++ b/nx-dev/ui-common/src/lib/headers/documentation-header.tsx
@@ -1,5 +1,5 @@
 'use client';
-import { Fragment, ReactElement } from 'react';
+import { Fragment, type MouseEvent, ReactElement } from 'react';
 import { NxCloudAnimatedIcon, NxIcon } from '@nx/nx-dev/ui-icons';
 import {
   Bars3Icon,
@@ -74,6 +74,11 @@ export function DocumentationHeader({
     !isChangelog &&
     !isAiChat;
 
+  const handleContextMenu = (e: MouseEvent) => {
+    e.preventDefault();
+    router.push('/brands');
+  };
+
   const sections = [
     { name: 'Nx', href: '/getting-started/intro', current: isNx },
     {
@@ -217,8 +222,11 @@ export function DocumentationHeader({
             href="/"
             className="flex flex-grow items-center px-4 text-slate-900 lg:px-0 dark:text-white"
             prefetch={false}
+            onContextMenu={handleContextMenu}
           >
-            <span className="sr-only">Nx</span>
+            <span className="sr-only">
+              Nx – Left-click: Home. Right-click: Brands.
+            </span>
             <NxIcon aria-hidden="true" className="h-8 w-8" />
           </Link>
           <Link
diff --git a/nx-dev/ui-common/src/lib/headers/header.tsx b/nx-dev/ui-common/src/lib/headers/header.tsx
index 99360f1741..f8380eff8e 100644
--- a/nx-dev/ui-common/src/lib/headers/header.tsx
+++ b/nx-dev/ui-common/src/lib/headers/header.tsx
@@ -17,13 +17,20 @@ import {
 } from '@heroicons/react/24/outline';
 import cx from 'classnames';
 import Link from 'next/link';
-import { Fragment, ReactElement, useEffect, useState } from 'react';
+import {
+  Fragment,
+  type MouseEvent,
+  ReactElement,
+  useEffect,
+  useState,
+} from 'react';
 import { ButtonLink, ButtonLinkProps } from '../button';
 import { resourceMenuItems } from './menu-items';
 import { MobileMenuItem } from './mobile-menu-item';
 import { SectionsMenu } from './sections-menu';
 import { AlgoliaSearch } from '@nx/nx-dev/feature-search';
 import { GitHubIcon, NxIcon } from '@nx/nx-dev/ui-icons';
+import { useRouter } from 'next/navigation';
 
 interface HeaderProps {
   ctaButtons?: ButtonLinkProps[];
@@ -32,6 +39,13 @@ interface HeaderProps {
 export function Header({ ctaButtons }: HeaderProps): ReactElement {
   let [isOpen, setIsOpen] = useState(false);
 
+  const router = useRouter();
+
+  const handleContextMenu = (e: MouseEvent) => {
+    e.preventDefault();
+    router.push('/brands');
+  };
+
   // We need to close the popover if the route changes or the window is resized to prevent the popover from being stuck open.
   const checkSizeAndClosePopover = () => {
     const breakpoint = 1024; // This is the standard Tailwind lg breakpoint value
@@ -78,8 +92,11 @@ export function Header({ ctaButtons }: HeaderProps): ReactElement {
             href="/"
             className="mr-4 flex items-center text-slate-900 dark:text-white"
             prefetch={false}
+            onContextMenu={handleContextMenu}
           >
-            <span className="sr-only">Nx</span>
+            <span className="sr-only">
+              Nx – Left-click: Home. Right-click: Brands.
+            </span>
             <NxIcon aria-hidden="true" className="h-8 w-8" />
           </Link>
           <nav
diff --git a/nx-dev/ui-company/src/lib/layout.tsx b/nx-dev/ui-company/src/lib/layout.tsx
index 883d8a7bf5..f9fd7b8930 100644
--- a/nx-dev/ui-company/src/lib/layout.tsx
+++ b/nx-dev/ui-company/src/lib/layout.tsx
@@ -21,7 +21,9 @@ export function Layout({
             }}
           />
         </div>
-        <main className="py-24 sm:py-32">{children}</main>
+        <main className="py-24 sm:py-32" data-document="main">
+          {children}
+        </main>
       </div>
       <Footer />
     </div>
diff --git a/nx-dev/ui-enterprise/src/lib/enterprise-layout.tsx b/nx-dev/ui-enterprise/src/lib/enterprise-layout.tsx
index e77c118fc8..ca4a4d1dc9 100644
--- a/nx-dev/ui-enterprise/src/lib/enterprise-layout.tsx
+++ b/nx-dev/ui-enterprise/src/lib/enterprise-layout.tsx
@@ -7,7 +7,7 @@ export function EnterpriseLayout({
   return (
     <div className="w-full dark:bg-slate-950">
       <Header />
-      <main>{children}</main>
+      <main data-document="main">{children}</main>
       <Footer />
     </div>
   );