Usage guidelines

Our new grid component has inbuilt side panels, including the side navigation and aside, which automatically resizes the grid to cover the main content area. To set up the grid:

  1. Determine grid type

  2. Select grid breakpoint

  3. Configure sideNavigation and aside

  4. Align content to grid

Diagram showing the properties of the grid component: type, breakpoint, side navigation and aside

Step 1: Determine grid type

There are 2 grid types:

  • Fluid grids fill the width of the screen

  • Fixed grids stretch to a max-width and then remain centered

Do

Use fluid grids for information-dense pages, such as kanban boards, to maximise screen real estate.

Don’t

Don’t use fluid grids for content-focused pages. Long line lengths impair readability.

Do

Use fixed grids for content-focused pages, such as blogs and articles, to improve readability.

Don’t

Don’t use fixed grids for information-dense pages. Limiting screen space will truncate important content.

Step 2: Select grid breakpoint

There are 6 grid breakpoints:

  • XXS, XS and S for small viewports from 320-1023px

  • M, L and XL for large viewports from 1024+px

Do

Span only the main content container. Exclude the side navigation and asides.

Don’t

Don’t span the entire screen width or include asides. The grid spacing is suitable for main content only.

Do

Set the grid breakpoint to the full viewport width.

Don’t

Don’t set the breakpoint to the container width. The grid spacing is scaled for the full viewport width.

Do

Change the breakpoint using the component variant.

Don’t

Don’t change the breakpoint by resizing the grid container. The linked grid styles will map incorrectly.

Do

Provide designs for at least 2 breakpoints, preferably more and for different devices.

Don’t

Don’t provide designs for only 1 breakpoint. Engineers need layout guidance for other breakpoints too.

Step 3: Configure side navigation and aside

There are 2 types of panels:

  • Side navigation: generally on the left, with collapsed and default states

  • Aside: generally on the right, with collapsed and default states where widths change at different breakpoints

Do

Follow the standard aside widths that are defined in the grid component properties.

Don’t

Don’t create custom aside sizes. This leads to inconsistent page layouts.

Step 4: Align content to grid

The vast majority of content should align to the grid, but exceptions can be made based on context. Use spacing tokens and layout primitives to structure content that doesn’t align to the grid.

Do

Use auto layout in Figma to align content, with appropriate spacing tokens.

Don’t

Don’t manually align content or set custom (non-token) values. This is not scalable and creates room for error.

Do

Align large content elements, such as cards to the grid.

Don’t

Don’t align small content elements, such as button groups, to the grid. Instead, use layout primitives.

Do

Align content across any number of columns required.

Don’t

Don’t allow content to overflow into gutters and margins, as this does not align with the grid.


Was this page helpful?

We use this feedback to improve our documentation.