Skip to content

forcedotcom/sf-skills / skills/design-systems-slds-apply

design-systems-slds-apply

Unverified

Apply SLDS-compliant UI using the correct blueprints, styling hooks, utility classes, and icons. Use when building any UI that needs SLDS, choosing between Lightning Base Components and SLDS Blueprints, applying styling hooks for theming, using utility classes for layout and spacing, or selecting icons. Triggers include "build a modal", "create a form", "data table", "SLDS styling", "style with hooks", "add an icon".

FileKindSize
SKILL.mdskill md14.6 KB
assets/README.mdmarkdown2.3 KB
assets/blueprints/components/accordion.yamlconfig15.0 KB
assets/blueprints/components/activity-timeline.yamlconfig3.8 KB
assets/blueprints/components/alert.yamlconfig4.4 KB
assets/blueprints/components/app-launcher.yamlconfig3.8 KB
assets/blueprints/components/avatar-group.yamlconfig3.2 KB
assets/blueprints/components/avatar.yamlconfig3.5 KB
assets/blueprints/components/badges.yamlconfig3.3 KB
assets/blueprints/components/brand-band.yamlconfig12.9 KB
assets/blueprints/components/breadcrumbs.yamlconfig4.0 KB
assets/blueprints/components/builder-header.yamlconfig10.1 KB
assets/blueprints/components/button-groups.yamlconfig3.1 KB
assets/blueprints/components/button-icons.yamlconfig12.9 KB
assets/blueprints/components/buttons.yamlconfig9.4 KB
assets/blueprints/components/cards.yamlconfig4.6 KB
assets/blueprints/components/carousel.yamlconfig6.0 KB
assets/blueprints/components/chat.yamlconfig9.7 KB
assets/blueprints/components/checkbox-button-group.yamlconfig8.3 KB
assets/blueprints/components/checkbox-button.yamlconfig13.8 KB
assets/blueprints/components/checkbox-toggle.yamlconfig7.7 KB
assets/blueprints/components/checkbox.yamlconfig4.4 KB
assets/blueprints/components/color-picker.yamlconfig8.5 KB
assets/blueprints/components/combobox.yamlconfig5.5 KB
assets/blueprints/components/counter.yamlconfig6.6 KB
assets/blueprints/components/data-tables.yamlconfig6.0 KB
assets/blueprints/components/datepickers.yamlconfig6.1 KB
assets/blueprints/components/datetime-picker.yamlconfig7.4 KB
assets/blueprints/components/docked-composer.yamlconfig13.3 KB
assets/blueprints/components/docked-form-footer.yamlconfig6.1 KB
assets/blueprints/components/docked-utility-bar.yamlconfig10.9 KB
assets/blueprints/components/drop-zone.yamlconfig4.5 KB
assets/blueprints/components/dueling-picklist.yamlconfig8.8 KB
assets/blueprints/components/dynamic-icons.yamlconfig5.0 KB
assets/blueprints/components/dynamic-menu.yamlconfig7.7 KB
assets/blueprints/components/expandable-section.yamlconfig4.6 KB
assets/blueprints/components/expression.yamlconfig7.3 KB
assets/blueprints/components/feeds.yamlconfig5.7 KB
assets/blueprints/components/file-selector.yamlconfig6.8 KB
assets/blueprints/components/files.yamlconfig4.8 KB
assets/blueprints/components/form-element.yamlconfig6.1 KB
assets/blueprints/components/global-header.yamlconfig4.7 KB
assets/blueprints/components/global-navigation.yamlconfig4.3 KB
assets/blueprints/components/icons.yamlconfig5.1 KB
assets/blueprints/components/illustration.yamlconfig8.5 KB
assets/blueprints/components/input.yamlconfig5.4 KB
assets/blueprints/components/list-builder.yamlconfig6.2 KB
assets/blueprints/components/lookups.yamlconfig5.8 KB
assets/blueprints/components/map.yamlconfig5.0 KB
assets/blueprints/components/menus.yamlconfig5.5 KB
assets/blueprints/components/modals.yamlconfig6.1 KB
assets/blueprints/components/notifications.yamlconfig3.1 KB
assets/blueprints/components/page-headers.yamlconfig6.0 KB
assets/blueprints/components/panels.yamlconfig6.8 KB
assets/blueprints/components/path.yamlconfig6.4 KB
assets/blueprints/components/picklist.yamlconfig5.2 KB
assets/blueprints/components/pills.yamlconfig5.9 KB
assets/blueprints/components/popovers.yamlconfig4.6 KB
assets/blueprints/components/progress-bar.yamlconfig4.4 KB
assets/blueprints/components/progress-indicator.yamlconfig5.6 KB
assets/blueprints/components/progress-ring.yamlconfig4.0 KB
assets/blueprints/components/prompt.yamlconfig5.5 KB
assets/blueprints/components/publishers.yamlconfig7.0 KB
assets/blueprints/components/radio-button-group.yamlconfig7.3 KB
assets/blueprints/components/radio-group.yamlconfig5.0 KB
assets/blueprints/components/rich-text-editor.yamlconfig6.0 KB
assets/blueprints/components/scoped-notifications.yamlconfig7.6 KB
assets/blueprints/components/scoped-tabs.yamlconfig3.7 KB
assets/blueprints/components/select.yamlconfig4.3 KB
assets/blueprints/components/setup-assistant.yamlconfig8.8 KB
assets/blueprints/components/slider.yamlconfig4.2 KB
assets/blueprints/components/spinners.yamlconfig5.4 KB
assets/blueprints/components/split-view.yamlconfig4.4 KB
assets/blueprints/components/summary-detail.yamlconfig4.1 KB
assets/blueprints/components/tabs.yamlconfig6.1 KB
assets/blueprints/components/textarea.yamlconfig4.6 KB
assets/blueprints/components/tiles.yamlconfig4.0 KB
assets/blueprints/components/timepicker.yamlconfig5.1 KB
assets/blueprints/components/toast.yamlconfig6.5 KB
assets/blueprints/components/tooltips.yamlconfig4.1 KB
assets/blueprints/components/tree-grid.yamlconfig4.9 KB
assets/blueprints/components/trees.yamlconfig4.8 KB
assets/blueprints/components/trial-bar.yamlconfig4.2 KB
assets/blueprints/components/vertical-navigation.yamlconfig5.2 KB
assets/blueprints/components/vertical-tabs.yamlconfig6.9 KB
assets/blueprints/components/visual-picker.yamlconfig6.8 KB
assets/blueprints/components/welcome-mat.yamlconfig5.5 KB
assets/hooks-index.jsonconfig141.1 KB
assets/icon-metadata.jsonconfig919.3 KB
assets/utilities-index.jsonconfig508.6 KB
references/README.mdmarkdown5.8 KB
references/blueprints-index.mdmarkdown9.0 KB
references/checklists.mdmarkdown3.8 KB
references/component-selection.mdmarkdown3.7 KB
references/examples.mdmarkdown8.1 KB
references/icons-decision-guide.mdmarkdown3.8 KB
references/icons-guidance.mdmarkdown6.2 KB
references/overviews/borders.mdmarkdown11.0 KB
references/overviews/color.mdmarkdown12.0 KB
references/overviews/display-density.mdmarkdown18.7 KB
references/overviews/icons.mdmarkdown9.3 KB
references/overviews/illustrations.mdmarkdown10.3 KB
references/overviews/shadows.mdmarkdown7.0 KB
references/overviews/spacing.mdmarkdown9.8 KB
references/overviews/typography.mdmarkdown14.8 KB
references/overviews/utilities.mdmarkdown23.9 KB
references/slds-development-guide.mdmarkdown8.8 KB
references/styling-decision-guide.mdmarkdown9.3 KB
references/styling-hooks/borders.mdmarkdown9.0 KB
references/styling-hooks/color/expressive-palette-hooks.mdmarkdown6.7 KB
references/styling-hooks/color/index.mdmarkdown6.5 KB
references/styling-hooks/color/semantic/accent-hooks.mdmarkdown9.9 KB
references/styling-hooks/color/semantic/feedback-hooks.mdmarkdown33.4 KB
references/styling-hooks/color/semantic/surface-hooks.mdmarkdown17.1 KB
references/styling-hooks/color/system-hooks.mdmarkdown5.8 KB
references/styling-hooks/index.mdmarkdown10.8 KB
references/styling-hooks/shadows.mdmarkdown8.3 KB
references/styling-hooks/spacing.mdmarkdown12.3 KB
references/styling-hooks/typography.mdmarkdown17.8 KB
references/utilities-quick-ref.mdmarkdown3.7 KB
references/utilities/alignment.mdmarkdown3.7 KB
references/utilities/borders.mdmarkdown4.0 KB
references/utilities/box.mdmarkdown4.3 KB
references/utilities/color.mdmarkdown7.7 KB
references/utilities/dark-mode.mdmarkdown3.5 KB
references/utilities/description-list.mdmarkdown5.5 KB
references/utilities/floats.mdmarkdown3.8 KB
references/utilities/grid.mdmarkdown9.7 KB
references/utilities/horizontal-list.mdmarkdown3.7 KB
references/utilities/hyphenation.mdmarkdown2.3 KB
references/utilities/index.mdmarkdown6.6 KB
references/utilities/interactions.mdmarkdown3.1 KB
references/utilities/layout.mdmarkdown3.6 KB
references/utilities/line-clamp.mdmarkdown4.3 KB
references/utilities/margin.mdmarkdown5.2 KB
references/utilities/media-object.mdmarkdown5.3 KB
references/utilities/name-value-list.mdmarkdown4.8 KB
references/utilities/padding.mdmarkdown5.3 KB
references/utilities/position.mdmarkdown5.9 KB
references/utilities/print.mdmarkdown3.0 KB
references/utilities/scrollable.mdmarkdown4.1 KB
references/utilities/sizing.mdmarkdown5.7 KB
references/utilities/themes.mdmarkdown4.0 KB
references/utilities/truncate.mdmarkdown3.7 KB
references/utilities/typography.mdmarkdown4.6 KB
references/utilities/vertical-list.mdmarkdown5.1 KB
references/utilities/visibility.mdmarkdown6.1 KB
scripts/search-blueprints.cjsscript3.6 KB
scripts/search-hooks.cjsscript4.4 KB
scripts/search-icons.cjsscript6.1 KB
scripts/search-utilities.cjsscript5.3 KB

references/utilities/grid.md

View on GitHub
---
id: slds.guidance.utilities.grid
title: Grid Utilities
description: SLDS flexbox grid system utilities
summary: "Utilities for flexible, responsive layouts using CSS Flexbox. Includes grid containers, columns, gutters (2px-96px), alignment, and responsive breakpoints."

artifact_type: reference
domain: utilities
topic: grid

content_format: structured
complexity: intermediate
audience: [implementer]

tasks: [implement]

refs:
  - slds.guidance.utilities
  - slds.guidance.overview.utilities
  - slds.guidance.utilities.sizing

tags: [utilities, grid, flexbox, layout, responsive]
keywords: [slds-grid, slds-col, slds-wrap, slds-gutters, slds-container]
---

# Grid - Flexbox Layout System

Creating flexible, responsive layouts using CSS Flexbox.

## Core Classes

| Class | Purpose |
|-------|---------|
| `slds-grid` | Initialize flex container (`display: flex`) |
| `slds-col` | Initialize flex item/column (`flex: 1 1 auto`) |
| `slds-wrap` | Allow columns to wrap to new rows (`flex-wrap: wrap`) |
| `slds-nowrap` | Keep columns on single line (`flex-wrap: nowrap`) |

## Grid Flow Modifiers

| Class | Purpose |
|-------|---------|
| `slds-grid_vertical` | Stack columns vertically (`flex-direction: column`) |
| `slds-grid_vertical-reverse` | Stack columns vertically in reverse order (`flex-direction: column-reverse`) |
| `slds-grid_reverse` | Reverse horizontal flow (`flex-direction: row-reverse`) |
| `slds-grid_frame` | Full-viewport grid (`min-width: 100vw; min-height: 100vh`) |
| `slds-grid_overflow` | Create horizontal scrolling grid (`flex-flow: row nowrap`) |

## Gutters

| Class | Gutter Width | Per Side |
|-------|-------------|----------|
| `slds-gutters_xxx-small` | 2px total | 1px |
| `slds-gutters_xx-small` | 4px total | 2px |
| `slds-gutters_x-small` | 8px total | 4px |
| `slds-gutters_small` | 24px total | 12px |
| `slds-gutters` | 24px total (default) | 12px |
| `slds-gutters_medium` | 32px total | 16px |
| `slds-gutters_large` | 48px total | 24px |
| `slds-gutters_x-large` | 64px total | 32px |
| `slds-gutters_xx-large` | 96px total | 48px |

### Gutter Variants
- `slds-gutters_direct` - Apply gutters only to direct child columns (not nested grids)
- `slds-gutters_direct-xxx-small` through `slds-gutters_direct-xx-large` - Direct gutters with size variants

## Alignment

### Horizontal Alignment (Main Axis)
| Class | Purpose |
|-------|---------|
| `slds-grid_align-center` | Center columns horizontally (`justify-content: center`) |
| `slds-grid_align-space` | Equal space around columns (`justify-content: space-around`) |
| `slds-grid_align-spread` | Space columns from edges (`justify-content: space-between`) |
| `slds-grid_align-end` | Right align columns (`justify-content: flex-end`) |

### Vertical Alignment (Cross Axis)
| Class | Purpose |
|-------|---------|
| `slds-grid_vertical-align-start` | Align columns to top (`align-items: flex-start`) |
| `slds-grid_vertical-align-center` | Vertically center columns (`align-items: center`) |
| `slds-grid_vertical-align-end` | Align columns to bottom (`align-items: flex-end`) |
| `slds-grid_vertical-stretch` | Stretch columns to fill height (`align-items: stretch`) |

### Individual Column Alignment
| Class | Purpose |
|-------|---------|
| `slds-align-top` | Align individual column to top (`align-self: flex-start`) |
| `slds-align-middle` | Align individual column to middle (`align-self: center`) |
| `slds-align-bottom` | Align individual column to bottom (`align-self: flex-end`) |

## Column Flex Control

| Class | Purpose |
|-------|---------|
| `slds-grow` | Allow column to grow (`flex-grow: 1`) |
| `slds-grow-none` | Prevent column from growing (`flex-grow: 0`) |
| `slds-shrink` | Allow column to shrink (`flex-shrink: 1`) |
| `slds-shrink-none` | Prevent column from shrinking (`flex-shrink: 0`) |
| `slds-no-flex` | Remove flexbox from column (`flex: none`) |
| `slds-no-space` | Set column to min-width of 0 |
| `slds-has-flexi-truncate` | Enable truncation in flexible container (`flex: 1 1 0%; min-width: 0`) |

## Column Positioning

| Class | Purpose |
|-------|---------|
| `slds-col_bump-top` | Push column to top using `margin-block-start: auto` |
| `slds-col_bump-right` | Push column to right using `margin-inline-end: auto` |
| `slds-col_bump-bottom` | Push column to bottom using `margin-block-end: auto` |
| `slds-col_bump-left` | Push column to left using `margin-inline-start: auto` |

## Column Borders

| Class | Purpose |
|-------|---------|
| `slds-col_rule-top` | Add 1px border to top side (large screens only) |
| `slds-col_rule-right` | Add 1px border to right side (large screens only) |
| `slds-col_rule-bottom` | Add 1px border to bottom side (large screens only) |
| `slds-col_rule-left` | Add 1px border to left side (large screens only) |

## Container Sizing

| Class | Max Width | Purpose |
|-------|-----------|---------|
| `slds-container_small` | 480px | Restrict width for small content |
| `slds-container_medium` | 768px | Restrict width for medium content |
| `slds-container_large` | 1024px | Restrict width for large content |
| `slds-container_x-large` | 1280px | Restrict width for extra large content |
| `slds-container_fluid` | 100% | Full viewport width |

### Container Positioning
| Class | Purpose |
|-------|---------|
| `slds-container_center` | Center container horizontally |
| `slds-container_left` | Left align container |
| `slds-container_right` | Right align container |

## Pull Padded Utilities

| Class | Purpose |
|-------|---------|
| `slds-grid_pull-padded` | Normalize 12px padding when nesting |
| `slds-grid_pull-padded-xxx-small` | Normalize 2px padding |
| `slds-grid_pull-padded-xx-small` | Normalize 4px padding |
| `slds-grid_pull-padded-x-small` | Normalize 8px padding |
| `slds-grid_pull-padded-small` | Normalize 12px padding |
| `slds-grid_pull-padded-medium` | Normalize 16px padding |
| `slds-grid_pull-padded-large` | Normalize 24px padding |
| `slds-grid_pull-padded-x-large` | Normalize 32px padding |
| `slds-grid_pull-padded-xx-large` | Normalize 48px padding |

## Common Patterns

### Basic Three-Column Grid
```html
<!-- Equal width columns with gutters -->
<div class="slds-grid slds-wrap slds-gutters">
  <div class="slds-col slds-size_1-of-3">
    Column 1 content
  </div>
  <div class="slds-col slds-size_1-of-3">
    Column 2 content
  </div>
  <div class="slds-col slds-size_1-of-3">
    Column 3 content
  </div>
</div>
```

### Responsive Card Layout
```html
<!-- Mobile: full width, Tablet: half width, Desktop: third width -->
<div class="slds-grid slds-wrap slds-gutters_small">
  <div class="slds-col slds-size_1-of-1 slds-medium-size_1-of-2 slds-large-size_1-of-3">
    <article class="slds-card">Card 1</article>
  </div>
  <div class="slds-col slds-size_1-of-1 slds-medium-size_1-of-2 slds-large-size_1-of-3">
    <article class="slds-card">Card 2</article>
  </div>
  <div class="slds-col slds-size_1-of-1 slds-medium-size_1-of-2 slds-large-size_1-of-3">
    <article class="slds-card">Card 3</article>
  </div>
</div>
```

### Centered Modal Dialog
```html
<!-- Vertically and horizontally centered content -->
<div class="slds-grid slds-grid_align-center slds-grid_vertical-align-center slds-grid_frame">
  <div class="slds-col slds-container_small">
    <section class="slds-modal__container">
      Modal content here
    </section>
  </div>
</div>
```

### Sidebar Layout with Auto-push
```html
<!-- Sidebar with main content pushed to opposite side -->
<div class="slds-grid slds-gutters">
  <nav class="slds-col slds-size_3-of-12">
    Sidebar navigation
  </nav>
  <main class="slds-col slds-col_bump-left">
    <!-- bump-left creates margin-inline-start: auto -->
    Main content area
  </main>
</div>
```

### Nested Grid with Direct Gutters
```html
<!-- Parent grid with nested grid using direct gutters -->
<div class="slds-grid slds-wrap slds-gutters_direct-medium">
  <div class="slds-col slds-size_1-of-2">
    <div class="slds-grid slds-wrap slds-gutters_direct-small">
      <div class="slds-col slds-size_1-of-2">Nested 1</div>
      <div class="slds-col slds-size_1-of-2">Nested 2</div>
    </div>
  </div>
  <div class="slds-col slds-size_1-of-2">
    Parent column 2
  </div>
</div>
```

## Best Practices

✅ Use `slds-wrap` for responsive card layouts that need to stack on mobile
✅ Start mobile-first with `slds-size_1-of-1` then add breakpoint-specific sizes
✅ Use `slds-gutters_small` (24px) for standard spacing between columns
✅ Apply `slds-has-flexi-truncate` when text needs to truncate within flexible columns
✅ Use `slds-container_center` with `slds-container_large` for centered page layouts
✅ Apply `slds-grid_pull-padded` when nesting grids to maintain visual alignment

❌ Avoid nesting grids more than 2 levels deep
❌ Never use `slds-col` without a parent `slds-grid`
❌ Avoid mixing grid utilities with float-based layouts
❌ Never combine `slds-grid_align-spread` with `slds-gutters` (creates double spacing)

## Deprecated Utilities

The following grid utilities are deprecated. Use the specified replacements.

### Responsive Nowrap Classes
| Deprecated | Replacement |
|------------|-------------|
| `slds-nowrap_small` | Use responsive grid classes instead |
| `slds-nowrap_medium` | Use responsive grid classes instead |
| `slds-nowrap_large` | Use responsive grid classes instead |

### Column Padding Classes
| Deprecated | Replacement |
|------------|-------------|
| `slds-col_padded` | Use `slds-p-horizontal_small` |
| `slds-col_padded-medium` | Use `slds-p-horizontal_medium` |
| `slds-col_padded-large` | Use `slds-p-horizontal_large` |
| `slds-col_padded-around` | Use `slds-p-around_small` |
| `slds-col_padded-around-medium` | Use `slds-p-around_medium` |
| `slds-col_padded-around-large` | Use `slds-p-around_large` |

Note: Column sizing utilities (`slds-size_*`) are defined in the [Sizing Utilities](ref:slds.guidance.utilities.sizing) category, not grid utilities.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall