Breakpoints

Four core breakpoints based on common device sizes. Each has distinct layout rules.

Mobile 0 - 767px
Tablet 768 - 1023px
Desktop 1024 - 1439px
Wide 1440px+

Mobile

Max Width 767px
Columns 4
Gutter 16px
Margin 16px
@media (max-width: 767px) { }

Tablet

Range 768 - 1023px
Columns 8
Gutter 20px
Margin 24px
@media (min-width: 768px) and (max-width: 1023px) { }

Desktop

Range 1024 - 1439px
Columns 12
Gutter 24px
Container 1200px
@media (min-width: 1024px) and (max-width: 1439px) { }

Wide

Min Width 1440px+
Columns 12
Gutter 32px
Container 1400px
@media (min-width: 1440px) { }

Fluid Typography

Typography scales smoothly using clamp(). No jarring size jumps at breakpoints.

Display XL Hello clamp(3rem, 2rem + 5vw, 7rem)
Display LG Hello clamp(2.5rem, 2rem + 4vw, 6rem)
Display MD Hello clamp(2rem, 1.5rem + 3vw, 4.5rem)
H1 Heading One clamp(1.75rem, 1.5rem + 1.5vw, 3rem)
H2 Heading Two clamp(1.5rem, 1.25rem + 1vw, 2.25rem)
H3 Heading Three clamp(1.25rem, 1rem + 0.75vw, 1.75rem)

Size Scale by Breakpoint

Style Mobile Tablet Desktop Wide
Display XL 48px 72px 96px 112px
Display LG 40px 56px 80px 96px
Display MD 32px 48px 64px 72px
H1 28px 32px 40px 48px
H2 24px 28px 32px 36px
Body 16px 17px 18px 18px

Component Behavior

Components don't just shrink—they transform to serve each context appropriately.

Hero

Mobile
  • Layout: Stacked
  • Text: Centered
  • Avatar: 200px
  • CTAs: Stacked
Tablet
  • Layout: Stacked
  • Text: Centered
  • Avatar: 280px
  • CTAs: Inline
Desktop
  • Layout: Split (50/50)
  • Text: Left-aligned
  • Avatar: 360px
  • CTAs: Inline

Modal

Mobile
  • Position: Bottom sheet
  • Width: 100%
  • Radius: Top only
  • Animation: Slide up
Desktop
  • Position: Centered
  • Width: 600px
  • Radius: All corners
  • Animation: Scale + fade

Navigation

Mobile
  • Type: Bottom tab bar
  • Max items: 5
  • Labels: Visible
  • Menu: Hamburger
Desktop
  • Type: Top navigation
  • Max items: 8
  • Labels: Visible
  • Menu: Avatar dropdown

Avatar Sizes

Conversation
M
T
D
W
180px 240px 320px 400px
Sidebar
M
T
D
W
48px 56px 64px 72px

Touch Targets

Minimum touch target sizes ensure comfortable tapping on mobile devices.

Primary Actions

Buttons, main navigation

Mobile: 48px Tablet: 44px Desktop: 40px

Secondary Actions

Links, minor controls

Mobile: 44px Tablet: 40px Desktop: 36px

Compact

Toolbars, tabs, dense layouts

Mobile: 40px Tablet: 36px Desktop: 32px

Common Patterns

Stack to Split

Content stacks vertically on mobile, splits horizontally on desktop.

.container {
  flex-direction: column;
}
@media (min-width: 1024px) {
  .container {
    flex-direction: row;
  }
}

Centered on Mobile

Text centered on mobile, left-aligned on desktop.

.text {
  text-align: center;
}
@media (min-width: 1024px) {
  .text {
    text-align: left;
  }
}

Full Width Mobile

Buttons span full width on mobile, auto-width on desktop.

.button {
  width: 100%;
}
@media (min-width: 768px) {
  .button {
    width: auto;
  }
}

Hide on Mobile

Secondary content hidden on mobile, visible on larger screens.

.secondary {
  display: none;
}
@media (min-width: 768px) {
  .secondary {
    display: block;
  }
}

Animation Adjustments

Animations adapt to device capabilities for optimal performance.

Mobile

  • Duration: 0.9x (faster)
  • Complexity: Reduced
  • Parallax: Disabled

Faster animations, simpler effects for performance

Desktop

  • Duration: 1.0x (normal)
  • Complexity: Full
  • Parallax: Enabled

Wide

  • Duration: 1.1x (slower)
  • Complexity: Full
  • Parallax: Enabled

Slightly slower animations feel more elegant on large screens

Utility Classes

Pre-built utility classes for common responsive patterns.

Class Effect
.hide-mobile Hidden on mobile, visible elsewhere
.show-mobile-only Visible only on mobile
.hide-tablet Hidden on tablet
.text-center-mobile Centered text on mobile only
.text-left-desktop Left-aligned text on desktop+
.flex-col-mobile Column direction on mobile
.flex-row-desktop Row direction on desktop+
.grid-cols-1-mobile 1 column grid on mobile
.grid-cols-3-desktop 3 column grid on desktop+