2.0 alpha
These docs describe 2.0. Install it with @once-ui-system/core@alpha.
On 1.8.x? Read the 1.x docs
TrademarkTrademarkDocs
Ctrl k
Search docs...
Components

Grid

Updated: September 14, 2026
View on GitHub
Grid is the two-dimensional counterpart to Flex. Reach for it when children should line up in both directions — a card gallery, a pricing table, a stat row — rather than flow along one. Everything that is not flex-specific works exactly as it does on Flex: the same spacing, size, surface, display and text props, and the same breakpoint objects. Only the two below are its own. Three across, two on a tablet, one on a phone. The breakpoint objects cascade down, so m also covers s and xs unless one of them says otherwise.
Prop
Type
Default
columns
How many equal columns. Set it per breakpoint to reflow.
110234812567911
rows
How many equal rows. Usually left alone — rows follow from the content.
110234812567911
Prop
Type
Default
xl
Overrides applied at the xl breakpoint and below.
GridBreakpointProps
l
Overrides applied at the l breakpoint and below.
GridBreakpointProps
m
Overrides applied at the m breakpoint and below.
GridBreakpointProps
s
Overrides applied at the s breakpoint and below.
GridBreakpointProps
xs
Overrides applied at the xs breakpoint.
GridBreakpointProps
…and every FlexProps propinherited
Grid takes the same shared props as Flex. They are documented once, on the Flex page:
  • Flex — one-dimensional layout, and the shared prop reference
  • MasonryGrid — for items of uneven height
  • Structure — how a page is composed from these
Edit this page on GitHub
TrademarkTrademark
Built with curiosity by Lorant One and the Design Engineers Club