fix(docs): stop the sidebar drifting when page content resizes

[waleedlatif1]

Summary

• The docs sidebar visibly jumped whenever page content resized — expanding an FAQ row moved it 16.8px at a fixed scroll position, collapsing moved it back.
• Root cause: the sidebar used fumadocs' sticky positioning, and a sticky box is bottom-limited by its containing block. #nd-docs-layout ends ~660px above the document bottom because the site footer is a sibling of the layout, not a grid child. So across the entire footer the sidebar was pushed progressively upward, and any content-height change while the reader was in that zone moved it.
• Fix: pin the sidebar and its divider to the viewport. A fixed box ignores both the container's end and the document height, so neither the drift nor the jump can occur.

Why this is safe

• The grid columns are explicit (0px 300px 1fr 268px 0px), so taking the placeholder out of flow leaves its track intact — the content column does not move.
• left/width are restated because a fixed box no longer derives them from its grid cell; top/height still come from fumadocs' own utility classes.
• The footer was already opaque (bg-[var(--bg)]) and now out-stacks the sidebar (z-20) and divider (z-21) at z-22, so it slides over them at the end of the page.
• Desktop-only (min-width: 1024px) — mobile is untouched.

Testing

Measured with Playwright, before and after:

	before	after
sidebar shift on FAQ expand	+16.8px	0px
sidebar shift on collapse	−16.8px	0px
content column left / width	—	unchanged (0 delta)
sidebar top at page bottom	75.2 → drifting	92px, held

Interaction regression suite, all passing: sidebar link navigates, sidebar folder expands, content link clickable (the naive position: fixed attempt broke this — a full-width fixed aside intercepted every click), FAQ toggles, ToC link clickable, language selector still hidden.

Verified top: 92px holds at the page bottom on the docs, API-reference, academy and integrations layouts, with zero page errors. Screenshots checked in light and dark at top/middle/bottom, plus mobile. Production build passes (4,281 static pages), typecheck and biome clean.

Type of Change

• Bug fix

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Aug 5, 2026 11:27pm

[cursor]

PR Summary

Low Risk
Desktop-only CSS layout and stacking changes in the docs app; no auth, data, or API logic touched.

Overview
Fixes a visible sidebar jump on the docs site when page height changes (e.g. expanding an FAQ) while the reader is near the footer. Fumadocs’ sticky sidebar was bounded by #nd-docs-layout, which ends above the site footer, so the sidebar drifted upward over the footer zone and shifted on content resize.

On desktop (min-width: 1024px), [data-sidebar-placeholder] and the #nd-docs-layout::before divider are position: fixed with explicit left/width (and the divider’s existing top/height), so they stay pinned to the viewport instead of the layout box. Grid column tracks stay explicit, so the main column layout is unchanged.

The footer gets relative z-[22] so it stacks above the sidebar (z-20) and divider (z-21) and covers them at the bottom of the page rather than showing through.

^{Reviewed by Cursor Bugbot for commit 94d9235. Configure here.}

[greptile-apps]

Greptile Summary

The PR pins the desktop docs sidebar and divider to the viewport to prevent content-resize drift, while moving footer stacking onto the footer component.

• Fixes the sidebar placeholder and divider at desktop widths.
• Places the site footer above the fixed sidebar and divider.
• Removes obsolete grid placement from the fixed divider.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
apps/docs/app/global.css	Pins the desktop sidebar and divider to viewport-derived positions and removes grid declarations made inert by fixed positioning.
apps/docs/components/footer/footer.tsx	Adds a documented stacking level so the footer paints over the fixed sidebar and divider.

_{Reviews (2): Last reviewed commit: "refactor(docs): drop dead grid placement..." | Re-trigger Greptile}

[waleedlatif1]

@greptile

[waleedlatif1]

@cursor review

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 94d9235. Configure here.}