Skip to content

Layout Grid

A visual guide to the FumaDocs 5-column grid architecture.

The starlight-fumadocs theme is built on a high-performance 5-column CSS Grid. This architecture ensures that the sidebars have edge-to-edge backgrounds while the content remains perfectly centered and readable.

The diagram below visualizes the active grid areas on this page. Note how the Main Content is flanked by flexible padding tracks and dedicated navigation rails.

LP1fr
Sidebar268px
Main Content AreaMax 1000px
TOC240px
RP1fr
Open Live Grid Test

The grid spans the full viewport width (100vw). By using 1fr for the padding tracks (LP and RP), the content area naturally centers itself while the sidebars remain fixed in width.

  • Responsive Scaling: As you resize the window, the 1fr tracks shrink first.
  • Edge-to-Edge: The Sidebar and TOC regions use their grid columns to anchor background colors that extend to the browser edges.
  • TOC Sync: The right-hand rail is where the Worm Glide indicator lives, perfectly aligned with the right-sidebar track.

Toggle between different screen sizes using the device switcher in the preview bar below to see how the grid architecture adapts in real-time.

/grid-test