Skip to content

[DX-1371] New navigation polish and mobile fixes#3395

Merged
m-hulbert merged 7 commits into
mainfrom
dx-1371-nav-fixes
Jun 5, 2026
Merged

[DX-1371] New navigation polish and mobile fixes#3395
m-hulbert merged 7 commits into
mainfrom
dx-1371-nav-fixes

Conversation

@m-hulbert
Copy link
Copy Markdown
Contributor

Description

This PR adds some small polishing to the new docs navigation, and fixes a bug with the mobile burger menu:

  • Makes both header button rows the same size
  • Aligns the product menu with the table of contents
  • Small adjustments to spacing in the table of contents
  • Removes the language dropdown when there's only a single language on the page
  • Sets the language dropdown to a fixed width, rather than changes on language name length
  • Fixes a navigation on mobile whereby you couldn't access the platform pages

Checklist

@m-hulbert m-hulbert self-assigned this Jun 4, 2026
@m-hulbert m-hulbert added the review-app Create a Heroku review app label Jun 4, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 4, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: f84839c0-eaf8-42aa-88ee-7460864be2d1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch dx-1371-nav-fixes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ably-ci ably-ci temporarily deployed to ably-docs-dx-1371-nav-f-parf1n June 4, 2026 08:40 Inactive
@m-hulbert m-hulbert requested a review from matt423 June 4, 2026 08:53
Copy link
Copy Markdown
Member

@matt423 matt423 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good improvements generally but still some issues.

Still a horizontal scroll on the products and two vertical scrollbars
Image

There's multiple scroll bar when not really needed
Image

@ably-ci ably-ci temporarily deployed to ably-docs-dx-1371-nav-f-parf1n June 4, 2026 17:56 Inactive
@m-hulbert
Copy link
Copy Markdown
Contributor Author

Good spot @matt423 , fixed in 6bfd6b6

@m-hulbert m-hulbert requested a review from matt423 June 4, 2026 17:56
m-hulbert and others added 7 commits June 5, 2026 10:52
Remove 12px of left padding from the product bar's inner container (px-5
to pl-2 pr-5) so the leading product tab's icon lines up with the header
logo and page content gutter at 20px.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Pin the main header nav links (Platform/Products/Examples) to h-9 and
swap the product bar tabs from py-2 to h-9 so both rows are exactly 36px
tall. Previously the header links were ~32px and the product tabs ~35.6px
(padding + label3 line-height), so they didn't quite match.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The accordion content wrapper used p-1 with -m-1, cancelling out to a 0px
gap. Reduce the negative margin to -m-0.5 so the padding nets a 2px gap,
matching the design, while keeping enough padding to avoid clipping focus
rings and hover backgrounds during the open/close animation.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Bump the left sidebar section heading padding-bottom from pb-1.5 (6px) to
pb-2 (8px) to match the design.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
When a page exposes a single SDK language there is nothing to choose
between, so render a static, non-interactive element instead of a
disabled dropdown. It keeps the same bordered styling (icon, label,
version badge) but drops the Select wrapper and chevron. Applied to both
the single-language selector and each Client/Agent dual-language dropdown.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Pin the single-language selector trigger to a fixed 195px width with
left-aligned content and the chevron pushed to the right edge (ml-auto),
so switching languages no longer resizes the control or shifts the right
sidebar. Match the loading skeleton width so there is no hydration jump.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The mobile burger menu reused the desktop components, so both the Platform
and Products tabs rendered the active page's product nav, and tapping a
product navigated to its homepage instead of revealing its TOC.

- LeftSidebar takes an optional `product` override (omit = active page;
  a key forces that product; null shows the placeholder).
- ProductBar gains a selection mode (onSelectProduct/selectedProduct):
  product items become selectors instead of navigation links. Desktop is
  unchanged.
- Header wires the mobile tabs: Platform forces the platform TOC; the
  Products tab tracks a selected product (defaulting to the current
  non-platform product) and shows its TOC inline. The burger now opens on
  the tab matching the current page (product -> Products, examples ->
  Examples, else Platform), and the selection resets on navigation.

DX-1371

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@m-hulbert m-hulbert force-pushed the dx-1371-nav-fixes branch from 6bfd6b6 to 2db3a6d Compare June 5, 2026 09:52
@ably-ci ably-ci temporarily deployed to ably-docs-dx-1371-nav-f-parf1n June 5, 2026 09:52 Inactive
@m-hulbert m-hulbert enabled auto-merge June 5, 2026 10:00
@m-hulbert m-hulbert merged commit 11d71f5 into main Jun 5, 2026
6 of 7 checks passed
@m-hulbert m-hulbert deleted the dx-1371-nav-fixes branch June 5, 2026 10:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-app Create a Heroku review app

Development

Successfully merging this pull request may close these issues.

3 participants