Box

Put simply, a box is a simple container. The box itself is not interactive: it has no hover, pressed, focus or disabled state.

Overview

When to use

  • Place most page content inside boxes, including H2-H4 and components
  • Boxes can contain any content, including body copy, selection cards, and buttons

When not to use

  • H1 and H1 subtitles live on the page (not inside a box.) Sometimes these page titles may have related components, like page-level actions or badges.
  • Side panels and dialogues. These have white backgrounds.

Specs

Similar styling as a card but it does not have a dropshadow.

Box-Specs-Web

 

Placement

Web

Space 16px apart

Box-Example-Placement-WebRelated

Disparate grouping

Space 40px apart

Box-Example-Placement-WebDisparate

 

Native app - Phone

Space 12px apart

Box-Example-Placement-NativeApp

 

Best Practices

Inverse

This style is pioneered by our brand team. Join our Brand Office Hours or reach out to brand directly for guidance in applying this inverse style.

Default

  • Style: Blondie (mono100) bkgd + White Stripes boxes
  • Use case: 95% of the product
Box-Example-InverseDefault

Inverse

  • Style: White Stripes (mono0) bkgd + Blondie (mono100) cards
  • Use case: zero state pages and monetization scenarios
Box-Example-InverseInverse

 

Interactive cards in boxes

How to style and when to use interactive cards within boxes

Specs

Not all these states apply to each interactive card

Read / complete

Read / complete

Unread / incomplete

Unread / incomplete

Hover

Hover

Pressed

Pressed

Active / open

Active / open

In boxes

Box-Example-InteractiveInBoxes

In accordions

Box-Example-InteractiveInAccordions

 

Examples

Desktop

Box-Example-Web2
Box-Example-Web3
Box-Example-Web1
Box-Example-Web4

 

Native app: phone

Box-Example-NativeAppPhone

 

Native app Component

 

Types

Basic Box

Basic Box

Form Box

Form Box

Table Box

Table Box

 

Do’s and Don’ts

 

Do
Box-Do-Dont-Alert-Do
Don’t
Box-Do-Dont-Alert-Dont

 

Do
Box-Do-Dont-Truncation-Do
Don’t
Box-Do-Dont-Truncation-Dont

 

 

Do
Box-Do-Dont-Icon-Do
Don’t
Box-Do-Dont-Icon-Dont

 

Examples

 

Basic Box

Dashboard

Dashboard

 

Form Box

Simple form

Simple form

Complex form

Complex form

 

Table Box

Simple table

Simple table

Complex table

Complex table

Form box: Editing

When a form box is in read-only mode, the button at the top right is “Edit.” Once edit has been tapped, the buttons change to “Cancel” and “Save.”

Box-Form-Edit
Box-Form-Edit-Save

 

Resources

(internal only)

Figma

Storybook