Layout

GridItem

A cell inside a fixed-column Grid (e.g. <Grid columns={12}>). Each item sets its own width with span, and an optional start line, using a fixed number or a responsive map at design-system breakpoints. Mirrors the shadcn col-span-N and MUI Grid size model.

Examples

8 / 4 split (responsive)
Loading preview
<Grid columns={12} gap="12px">
  <GridItem span={{ mobile: 12, desktop: 8 }}>main</GridItem>
  <GridItem span={{ mobile: 12, desktop: 4 }}>aside</GridItem>
</Grid>

API

PropTypeDefaultDescription
spannumber | { mobile?, tablet?, desktop? }1Number of parent tracks to span, or a responsive map.
startnumber | { mobile?, tablet?, desktop? }autoExplicit 1-based start line (or responsive map); omit to auto-place after the previous item.

Styling and attributes

Like every component, GridItem accepts the universal token style props (m, p, sx, display, responsive maps, ...) and forwards standard DOM attributes (id, data-*, aria-*, event handlers) to the underlying element. See Styling for the full API.

Guidelines

Do

  • Use GridItem only inside a fixed-column Grid (e.g. columns={12}).
  • Use a responsive span map so cells reflow on mobile.

Avoid

  • Do not use GridItem in the default equal-columns Grid; auto-placed cells do not need it.

Import from @hub/ds-components. Interactive playground: Storybook. Figma Code Connect node 299-140.