From d74f8a709882b05185bd4d14e2d0d28cbd18dee3 Mon Sep 17 00:00:00 2001
From: Zeno Kapitein <zeno@gitbook.io>
Date: Fri, 3 Oct 2025 18:52:05 +0200
Subject: [PATCH] Improve wide page width (#3692)

---
 .changeset/silly-ducks-kiss.md                |  5 ++
 .../src/components/DocumentView/Blocks.tsx    |  2 +-
 .../src/components/PageAside/PageAside.tsx    |  1 +
 .../src/components/PageBody/PageBody.tsx      |  4 +-
 .../src/components/SitePage/SitePage.tsx      | 66 ++++++++++---------
 .../components/SpaceLayout/SpaceLayout.tsx    |  3 +-
 6 files changed, 46 insertions(+), 35 deletions(-)
 create mode 100644 .changeset/silly-ducks-kiss.md

diff --git a/.changeset/silly-ducks-kiss.md b/.changeset/silly-ducks-kiss.md
new file mode 100644
index 000000000..5cb015ed6
--- /dev/null
+++ b/.changeset/silly-ducks-kiss.md
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Improve wide page width layout
diff --git a/packages/gitbook/src/components/DocumentView/Blocks.tsx b/packages/gitbook/src/components/DocumentView/Blocks.tsx
index 04ae481aa..6d1f408cd 100644
--- a/packages/gitbook/src/components/DocumentView/Blocks.tsx
+++ b/packages/gitbook/src/components/DocumentView/Blocks.tsx
@@ -89,7 +89,7 @@ export function UnwrappedBlocks<TBlock extends DocumentBlock>(props: UnwrappedBl
                     node.data && 'fullWidth' in node.data && node.data.fullWidth
                         ? 'max-w-screen-xl'
                         : 'max-w-3xl',
-                    FULL_WIDTH_BLOCKS.includes(node.type) && 'page-width-wide:max-w-screen-2xl',
+                    FULL_WIDTH_BLOCKS.includes(node.type) && 'page-width-wide:max-w-full',
                     blockStyle,
                 ]}
                 isEstimatedOffscreen={isOffscreen}
diff --git a/packages/gitbook/src/components/PageAside/PageAside.tsx b/packages/gitbook/src/components/PageAside/PageAside.tsx
index bc0570c41..6b14991f9 100644
--- a/packages/gitbook/src/components/PageAside/PageAside.tsx
+++ b/packages/gitbook/src/components/PageAside/PageAside.tsx
@@ -35,6 +35,7 @@ export function PageAside(props: {
         <aside
             className={tcls(
                 'group/aside',
+                'order-last',
                 'hidden',
                 'pt-8',
                 'pb-4',
diff --git a/packages/gitbook/src/components/PageBody/PageBody.tsx b/packages/gitbook/src/components/PageBody/PageBody.tsx
index 4b674789a..6f1e8bfca 100644
--- a/packages/gitbook/src/components/PageBody/PageBody.tsx
+++ b/packages/gitbook/src/components/PageBody/PageBody.tsx
@@ -51,10 +51,10 @@ export function PageBody(props: {
             <main
                 className={tcls(
                     'relative min-w-0 flex-1',
-                    'mx-auto max-w-screen-2xl py-8',
+                    'max-w-screen-2xl py-8',
                     // Allow words to break if they are too long.
                     'break-anywhere',
-                    pageWidthWide ? 'page-width-wide 2xl:px-8' : 'page-width-default',
+                    pageWidthWide ? 'page-width-wide 3xl:px-8' : 'page-width-default',
                     siteWidthWide ? 'site-width-wide' : 'site-width-default',
                     page.layout.tableOfContents ? 'page-has-toc' : 'page-no-toc'
                 )}
diff --git a/packages/gitbook/src/components/SitePage/SitePage.tsx b/packages/gitbook/src/components/SitePage/SitePage.tsx
index a6956d57a..4f0643cee 100644
--- a/packages/gitbook/src/components/SitePage/SitePage.tsx
+++ b/packages/gitbook/src/components/SitePage/SitePage.tsx
@@ -43,38 +43,42 @@ export async function SitePage(props: SitePageProps) {
 
     return (
         <PageContextProvider pageId={page.id} spaceId={context.space.id} title={page.title}>
-            {withFullPageCover && page.cover ? (
-                <PageCover as="full" page={page} cover={page.cover} context={context} />
-            ) : null}
-            {/* We use a flex row reverse to render the aside first because the page is streamed. */}
-            <div
-                className={tcls(
-                    'flex grow flex-row-reverse justify-end',
-                    withSections
-                        ? '[--content-scroll-margin:calc(var(--spacing)*27)]'
-                        : '[--content-scroll-margin:calc(var(--spacing)*16)]'
-                )}
-            >
-                <PageAside
-                    page={page}
-                    document={document}
-                    withHeaderOffset={headerOffset}
-                    withFullPageCover={withFullPageCover}
-                    withPageFeedback={withPageFeedback}
-                    context={context}
-                />
-                <PageBody
-                    context={context}
-                    page={page}
-                    ancestors={ancestors}
-                    document={document}
-                    withPageFeedback={withPageFeedback}
-                    insightsDisplayContext={SiteInsightsDisplayContext.Site}
-                />
+            {/* Using `contents` makes the children of this div according to its parent — which keeps them in a single flex row with the TOC by default.
+            If there's a page cover, we use `flex flex-col` to lay out the PageCover above the PageBody + PageAside instead. */}
+            <div className={withFullPageCover && page.cover ? 'flex grow flex-col' : 'contents'}>
+                {withFullPageCover && page.cover ? (
+                    <PageCover as="full" page={page} cover={page.cover} context={context} />
+                ) : null}
+
+                <div
+                    className={tcls(
+                        withFullPageCover && page.cover ? 'flex grow flex-row' : 'contents',
+                        withSections
+                            ? '[--content-scroll-margin:calc(var(--spacing)*27)]'
+                            : '[--content-scroll-margin:calc(var(--spacing)*16)]'
+                    )}
+                >
+                    <PageAside
+                        page={page}
+                        document={document}
+                        withHeaderOffset={headerOffset}
+                        withFullPageCover={withFullPageCover}
+                        withPageFeedback={withPageFeedback}
+                        context={context}
+                    />
+                    <PageBody
+                        context={context}
+                        page={page}
+                        ancestors={ancestors}
+                        document={document}
+                        withPageFeedback={withPageFeedback}
+                        insightsDisplayContext={SiteInsightsDisplayContext.Site}
+                    />
+                </div>
+                <React.Suspense fallback={null}>
+                    <PageClientLayout />
+                </React.Suspense>
             </div>
-            <React.Suspense fallback={null}>
-                <PageClientLayout />
-            </React.Suspense>
         </PageContextProvider>
     );
 }
diff --git a/packages/gitbook/src/components/SpaceLayout/SpaceLayout.tsx b/packages/gitbook/src/components/SpaceLayout/SpaceLayout.tsx
index 8d7bebe90..0a555f51c 100644
--- a/packages/gitbook/src/components/SpaceLayout/SpaceLayout.tsx
+++ b/packages/gitbook/src/components/SpaceLayout/SpaceLayout.tsx
@@ -137,6 +137,7 @@ export function SpaceLayout(props: SpaceLayoutProps) {
                         'flex',
                         'flex-col',
                         'lg:flex-row',
+                        'lg:justify-center',
                         CONTAINER_STYLE,
                         'site-width-wide:max-w-full',
 
@@ -223,7 +224,7 @@ export function SpaceLayout(props: SpaceLayoutProps) {
                             </>
                         }
                     />
-                    <div className="flex min-w-0 flex-1 flex-col">{children}</div>
+                    {children}
                 </div>
             </div>