Skip to content

docs(nav): add Resources and Support menu tabs, restyle tab bar to design pills - #172

Merged
soamdesai-tfh merged 8 commits into
mainfrom
soam/docs3-qa2-2-header
Sep 10, 2026
Merged

docs(nav): add Resources and Support menu tabs, restyle tab bar to design pills#172
soamdesai-tfh merged 8 commits into
mainfrom
soam/docs3-qa2-2-header

Conversation

@soamdesai-tfh

@soamdesai-tfh soamdesai-tfh commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Part of the Docs 3.0 QA round 2 series

Change

Implements the new header design — the single-row floating pill — plus the Resources/Support menus:

  • Floating pill header at ≥1440px (the design frame's stated range): Mintlify's two-row header collapses into the design's 84px rounded bar floating on the page background — logo left, tab pills centered (752px row, matching the mock's metrics: adjacent pills, 10px padding, 14px on the active pill), compact search pill and the Developer Portal CTA right. 63px side margins at the 1728px frame put the logo on the shared 96px page gutter. Between 1440–1600px the theme toggle steps aside for space; below 1440px the restyled two-row layout remains (and mobile is untouched).
  • Resources and Support join the tab bar as native dropdown (menu) tabs, separated from the page tabs by the design's hairline divider:
    • Resources: World Tech Blog · Open Source · Whitepaper · Ecosystem
    • Support: Telegram Support Channel · Email Support · Mini Apps FAQ
  • The old global sidebar anchors (Telegram / Email / GitHub) moved into these menus — the design's sidebar carries no anchors.
  • Tab styling per the design language: ink labels, black pill on the active tab (inverted in dark mode), no underline indicator.
  • Logo brought to the design spec: the pill renders it as the mock's 166px block, and the gap between the world mark and "Developers" inside the SVG (both variants) is tightened from ~12.6px to the design's 8.6px at header scale (wordmark shifted 6.1 viewBox units; this asset change applies at all breakpoints).

At pill widths the right side matches the mock exactly — Search plus (on the hosted site) the Ask Assistant pill, the design's "Ask AI". The Developer Portal CTA and the theme toggle are hidden there: Portal moves into the Resources menu, the theme follows the system preference, and both stay in the sub-1440 layouts and mobile nav. "Explore Integrations" is likewise hidden at pill widths (Ecosystem covers it in Resources and the footer). Remaining known deviation: the search pill says "Search…" (theme string). The dropdowns' contents are a best-guess mapping (the design shows them closed).

  • Resources menu now leads with Developer Portal.

Header

Before:

before

After (hosted preview at the 1728px design frame — real Ask Assistant pill; the header is one flex line, so the hosted Search/Ask cluster can never overlap the tabs):

after

…sign pills

Docs 3.0 QA: add the Resources and Support dropdown tabs from the new header
design (their menus absorb the old global sidebar anchors), separate them from
the page tabs with a hairline divider, and restyle the tab bar to the design
language: ink labels, black pill for the active tab (inverted in dark mode),
no underline indicator, search entry as a quiet bordered pill.
@mintlify

mintlify Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
world 🟢 Ready View Preview Sep 10, 2026, 9:05 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@soamdesai-tfh

Copy link
Copy Markdown
Contributor Author

Series (Docs 3.0 QA round 2, splitting #170 — all six are independent and merge in any order): #171 alignment · #172 header tabs · #173 footer · #174 chat launcher · #175 World Tech links · #176 sidebar selected state. Screenshots live on the assets-only branch soam/docs3-qa2-assets (never merge it).

Collapse the theme's two-row header into the design's floating 84px pill
at >=1440px: logo left, adjacent pill tabs centered (752px row per the
mock), compact search pill and CTA right, 63px side margins at the
1728px frame so the logo shares the 96px page gutter. Tab pills tighten
to the design metrics (zero gap, 10px padding, 14px on the active pill).
Between 1440-1600px the theme toggle steps aside; below 1440px the
two-row layout from the previous commit remains.
@soamdesai-tfh

Copy link
Copy Markdown
Contributor Author

Upgraded per QA feedback: this PR now implements the full single-row floating pill header at desktop widths (≥1440px) instead of only the two-row fallback — logo/tabs/search/CTA in one 84px rounded bar matching the mock's metrics (752px tab row, 63px margins at 1728px, logo on the 96px gutter). The after-screenshot in the description is retaken from this branch at the 1728px design frame. Below 1440px the previous two-row styling remains as the fallback.

The gap between the world mark and 'Developers' in the combined logo
SVGs rendered ~47% wider than the mock (12.6px vs 8.6px at the header
scale). Shift the wordmark 6.1 viewBox units left in both variants
(canvas 233 -> 226.9) so the gap ratio lands on the design's 5.16%,
and keep the pill-header logo block at the mock's 166px width.
Hide the Developer Portal CTA and the theme toggle at pill widths
(>=1440px): the design's header carries only the Search and Ask pills.
Developer Portal joins the Resources menu so it stays one click away;
the theme still follows the system preference, and both elements remain
in the sub-1440 layouts and mobile nav.
…ible

The hosted header carries a wide Search + Ask Assistant cluster that the
absolutely-centered tab row painted under at sub-1728 widths (tabs were
hidden behind the pills). Flatten the theme's two-row scaffolding with
display:contents so logo, tabs, and the cluster are items on ONE flex
line: auto margins center the tabs in the free space and the layout can
never overlap regardless of cluster width. Also style the hosted Ask
Assistant entry as the design's Ask pill and compact the search entry
by rule (the prod cluster lacks the justify-center class the previous
selector keyed on).
The pill's side margins jumped from 63px to 24px below 1600px, so the
bar visibly widened as the window shrank. Use the design frame's ratio
(63/1728 per side, 7.3vw total) continuously, capped at the 1602px
design width — same proportions at every desktop size, and the logo
stays on the 96px gutter at the 1728px frame.

@Takaros999 Takaros999 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed the current diff, surrounding source, checks, and hosted preview. No blocking findings. Preview verification was per PR; the combined merged layout was not tested.

@soamdesai-tfh
soamdesai-tfh merged commit 86d85e9 into main Sep 10, 2026
9 checks passed
@soamdesai-tfh
soamdesai-tfh deleted the soam/docs3-qa2-2-header branch September 10, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants