Skip to content

docs(home): align header and content to the 1728px/96px design frame - #171

Merged
soamdesai-tfh merged 1 commit into
mainfrom
soam/docs3-qa2-1-align
Sep 10, 2026
Merged

docs(home): align header and content to the 1728px/96px design frame#171
soamdesai-tfh merged 1 commit into
mainfrom
soam/docs3-qa2-1-align

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

Problem

At the 1728px design frame, Mintlify's header container is max-w-8xl with 48px gutters, so the logo and tabs sit at ~169px while the hero and every content section sit at 96px — the misalignment flagged in "Align the main content and hero width (homepage)".

Change

  • The navbar (both rows) and the docs-page body wrapper now use the design frame: 1728px max-width, 96px gutters, so the logo, tabs, hero, and content share one left edge (sidebar text lands at 96px under the logo on docs pages).
  • Homepage measurements matched to the design frame: hero subtitle 487px (wraps like the mock) with a 24px gap under the title, card icons 32px, card row gap 113px, story cards 756px wide with a 24px gap and the track bleeding into the right gutter so the third card peeks past the content edge (cards land at x = 96 / 876 / 1656, exactly the mock's grid), section rhythm 160/240/240.

Homepage — red dashes mark the 96px design gutter

Before (logo and tabs off the gutter):

before

After (header, hero, and content on one edge):

after

Docs pages

Before:

before

After:

after

Docs 3.0 QA: the navbar container was max-w-8xl with 48px gutters while the
hero and content sit at 96px. Match the navbar (both rows) and the docs-page
body wrapper to the 1728px design frame with 96px gutters, and bring the
homepage layout to the design measurements: hero subtitle 487px, card icons
32px, card row gap 113px, story cards 756px/24px gap bleeding into the right
gutter, section rhythm 160/240/240.
@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, 5:53 AM

💡 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).

@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 fc62e69 into main Sep 10, 2026
9 checks passed
@soamdesai-tfh
soamdesai-tfh deleted the soam/docs3-qa2-1-align 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