Fix scroll jump and scroll reset

[gregberge]

• Remove useless Suspense boundary
• Fix scroll not reset when navigating pages
• Fix scroll jump on page load

[linear]

RND-8498 scrollY persists on page change instead of starting at the top

[changeset-bot]

⚠️ No Changeset found

Latest commit: 17b6f2a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[Copilot]

Pull Request Overview

This PR fixes scroll behavior issues during page navigation by preventing scroll position persistence and eliminating scroll jumps on initial page load. The changes refactor scroll handling logic to use a custom hook and improve scroll-to-element functionality.

• Extracted scroll event handling into a reusable useScrollListener hook
• Added checks to prevent scroll behavior on initial page load (only trigger on navigation)
• Replaced scrollIntoView with custom scroll positioning logic for better control

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
packages/gitbook/src/components/primitives/ScrollContainer.tsx	Refactored scroll event handling to use useScrollListener hook and replaced scrollIntoView with custom scrollToElementInContainer function
packages/gitbook/src/components/hooks/useScrollPage.ts	Added guard to prevent scroll behavior on initial page load by checking for previous state
packages/gitbook/src/components/SitePage/SitePage.tsx	Removed unnecessary React.Suspense boundary around PageClientLayout

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-lg4ihx6or-gitbook.vercel.app	✅
Cloudflare	https://be3f71f2-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-lg4ihx6or-gitbook.vercel.app/url/gitbook.com/docs	https://be3f71f2-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-lg4ihx6or-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://be3f71f2-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	✅ No changes detected	-	Oct 25, 2025, 8:28 AM
v2-cloudflare (Inspect)	✅ No changes detected	-	Oct 25, 2025, 8:31 AM
v2-vercel (Inspect)	✅ No changes detected	-	Oct 25, 2025, 8:31 AM