Improve tabs

[gregberge]

Improve the tabs:

• Fix the tab selection from the anchor in the URL
• Remove the anchor from it, now if we click on a tab it changes the URL
• Fix the layout issue, now we can click on every part of the tab
• We now display the full label of the tab and we automatically display tabs that does not fit in a menu

Actual

New UX

CleanShot.2025-10-16.at.22.50.27.mp4

[linear]

RND-5530 Tabs should scale to more tab items

[changeset-bot]

⚠️ No Changeset found

Latest commit: 3c03cc8

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 enhances the tabs component by improving URL hash handling, fixing layout issues, and adding overflow menu functionality. The changes enable better tab navigation with URL synchronization while maintaining proper accessibility and visual presentation.

Key changes:

• Tabs now update the URL hash when selected, and tab selection is synchronized with URL hash changes
• Layout fixes allow clicking anywhere on the tab (not just the text) and properly display full tab labels
• Overflowing tabs are automatically moved to a dropdown menu with ellipsis icon

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
packages/gitbook/src/components/utils/link.ts	Added check to treat anchor links as internal links
packages/gitbook/src/components/hooks/useHash.tsx	Enabled navigation tracking for hash changes by removing hash exclusion and removing extraneous blank line
packages/gitbook/src/components/DocumentView/Tabs/DynamicTabs.tsx	Major refactoring: implemented URL hash synchronization, overflow detection with dropdown menu, and improved tab button layout
packages/gitbook/src/components/DocumentView/HashLinkButton.tsx	Replaced anchor tag with Link component and consolidated styling

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-ow1m0icym-gitbook.vercel.app	✅
Cloudflare	https://4eb9f5a8-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-ow1m0icym-gitbook.vercel.app/url/gitbook.com/docs	https://4eb9f5a8-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-ow1m0icym-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://4eb9f5a8-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)	👍 Changes approved	6 changed	Oct 16, 2025, 9:06 PM
v2-cloudflare (Inspect)	👍 Changes approved	4 changed	Oct 16, 2025, 9:10 PM
v2-vercel (Inspect)	👍 Changes approved	9 changed	Oct 16, 2025, 9:10 PM