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/blueprints-index.md

View on GitHub
---
id: slds.guidance.blueprints
title: SLDS Blueprints Index
description: Complete index of SLDS blueprints by category with Lightning component mapping
summary: "Index of SLDS blueprints across 9 categories (Actions, Input, Layout, Navigation, Display, Data, Feedback, Overlay, Complex Components). Covers when to use blueprints vs Lightning Base Components."

artifact_type: index
domain: blueprints
topic: blueprints

content_format: structured
complexity: intermediate
audience: [implementer]

tasks: [choose, learn]

refs:
  - slds.guidance.development
  - slds.guidance.design
  - slds.guidance.icons

tags: [blueprints, components, html, css, implementation]
keywords: [SLDS blueprints, component implementation, HTML structure, CSS classes, Lightning components, custom components]
---

# SLDS Blueprints Index

## Overview

Blueprints provide HTML structure, CSS classes, ARIA requirements, and code examples for each SLDS component. Each blueprint includes:

- **HTML structure**: Element hierarchy and required markup
- **CSS classes**: Root, element, modifier, size, and state classes
- **Styling hooks**: CSS custom properties for theming
- **Accessibility**: ARIA attributes, keyboard patterns, screen reader guidance
- **Code examples**: Usage examples for variants
- **Lightning component mapping**: Corresponding LWC when available

**Use blueprints** when building custom HTML/CSS, targeting non-Salesforce platforms, or when no Lightning Base Component exists.

**Use Lightning Base Components** when working within Salesforce (LWC, Aura, Visualforce) — they handle accessibility, events, and framework integration automatically.

---

## Blueprints by Category

### Actions

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Buttons** | Action triggers with text labels | `lightning-button` |
| **Button Icons** | Icon-only action triggers | `lightning-button-icon` |
| **Button Groups** | Related buttons in a row | `lightning-button-group` |
| **Docked Utility Bar** | Persistent bottom utility panel | N/A |

---

### Input

Form controls for user input and data entry.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Checkbox** | Binary selection control | `lightning-checkbox` |
| **Checkbox Button** | Checkbox styled as a button | `lightning-checkbox-button` |
| **Checkbox Button Group** | Set of checkbox buttons in a fieldset | `lightning-checkbox-group` |
| **Checkbox Toggle** | Toggle-style checkbox | `lightning-input` (type="checkbox-button") |
| **Combobox** | Text input with dropdown list | `lightning-combobox` |
| **Counter** | Number input with increment/decrement controls | N/A |
| **Datepickers** | Calendar date selection | `lightning-input` (type="date") |
| **Datetime Picker** | Combined date and time selection | `lightning-input` (type="datetime") |
| **Dueling Picklist** | Multi-select with two lists | `lightning-dual-listbox` |
| **Expression** | Formula builder interface | N/A |
| **File Selector** | File upload with drag-and-drop | `lightning-file-upload` |
| **Form Element** | Wrapper for form inputs | N/A |
| **Input** | Text/number input | `lightning-input` |
| **Lookups** | Search and select from a dataset | `lightning-record-picker` |
| **Picklist** | Dropdown from predefined options | `lightning-combobox` |
| **Radio Group** | Single selection from exclusive options | `lightning-radio-group` |
| **Radio Button Group** | Radio buttons in a styled group | `lightning-radio-group` |
| **Rich Text Editor** | Text editor with formatting toolbar | `lightning-input-rich-text` |
| **Select** | Native dropdown selection | `lightning-combobox` |
| **Slider** | Numeric range input via draggable handle | `lightning-slider` |
| **Textarea** | Multi-line text input | `lightning-textarea` |
| **Timepicker** | Time selection interface | `lightning-input` (type="time") |
| **Visual Picker** | Visual tile-based selection | `lightning-radio-group` (with tiles) |

---

### Layout

Components for organizing and structuring content.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Accordion** | Collapsible stacked sections | `lightning-accordion` |
| **Brand Band** | Visual header with branding | N/A |
| **Builder Header** | Header for app builder interfaces | N/A |
| **Cards** | Container with header/body/footer | `lightning-card` |
| **Carousel** | Slideshow with navigation controls | `lightning-carousel` |
| **Docked Form Footer** | Fixed bottom footer for form actions | N/A |
| **Expandable Section** | Collapsible content block | N/A |
| **Page Headers** | Page title, metadata, and actions | `lightning-record-view-form` |
| **Panels** | Structured side or overlay container | N/A |
| **Split View** | Resizable two-pane layout | N/A |
| **Summary Detail** | Collapsible key-value layout | N/A |
| **Tiles** | Card-like grid content items | `lightning-tile` |

---

### Navigation

Components for navigation and wayfinding.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **App Launcher** | Grid for app discovery | N/A |
| **Breadcrumbs** | Hierarchical location trail | `lightning-breadcrumbs` |
| **Dynamic Menu** | Contextual menu in popover | N/A |
| **Global Header** | Primary application header | N/A |
| **Global Navigation** | Main navigation bar | `lightning-navigation` |
| **Menus** | Contextual action lists | `lightning-menu-item` |
| **Path** | Linear process stage indicator | `lightning-path` |
| **Scoped Tabs** | Tabs scoped to a context | `lightning-tabset` |
| **Tabs** | Switchable content panels | `lightning-tabset` |
| **Trees** | Hierarchical list | `lightning-tree` |
| **Vertical Navigation** | Vertical nav menu | `lightning-vertical-navigation` |
| **Vertical Tabs** | Vertical tab interface | `lightning-vertical-navigation` |

---

### Display

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Activity Timeline** | Chronological event list | `lightning-activity-timeline` |
| **Avatar** | User or entity image placeholder | `lightning-avatar` |
| **Avatar Group** | Stacked avatar collection | N/A |
| **Badges** | Small status label | `lightning-badge` |
| **Dynamic Icons** | Animated contextual icons | N/A |
| **Files** | File attachment card | N/A |
| **Icons** | SVG icons from SLDS sprite | `lightning-icon` |
| **Illustration** | Empty/error state graphic | N/A |
| **Pills** | Removable tag or filter token | `lightning-pill` |

---

### Data

Components for displaying structured data.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Data Tables** | Sortable tabular data | `lightning-datatable` |
| **Tree Grid** | Hierarchical data table | `lightning-tree-grid` |

---

### Feedback

Components for communicating status and feedback.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Alert** | Page-level status banner | N/A |
| **Notifications** | System notification messages | N/A |
| **Progress Bar** | Linear completion indicator | `lightning-progress-bar` |
| **Progress Indicator** | Multi-step process tracker | `lightning-progress-indicator` |
| **Progress Ring** | Circular progress indicator | `lightning-progress-ring` |
| **Scoped Notifications** | Notification scoped to a container | N/A |
| **Spinners** | Loading state indicator | `lightning-spinner` |
| **Toast** | Temporary notification message | N/A |
| **Trial Bar** | Trial status and call-to-action bar | N/A |

---

### Overlay

Components that appear above the main interface.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Docked Composer** | Bottom-docked content creation panel | N/A |
| **Modals** | Blocking dialog overlay | N/A |
| **Popovers** | Contextual overlay anchored to trigger | N/A |
| **Prompt** | Confirmation or input dialog | N/A |
| **Tooltips** | Hover-triggered label | N/A |
| **Welcome Mat** | Onboarding introduction overlay | N/A |

---

### Complex Components

Advanced components with rich functionality.

| Blueprint | Description | Lightning Component |
|-----------|-------------|---------------------|
| **Chat** | Chronological chat message display | N/A |
| **Color Picker** | Color selection with hex/swatch input | N/A |
| **Drop Zone** | Drag-and-drop target area | N/A |
| **Feeds** | Chronological activity feed | N/A |
| **List Builder** | Drag-and-drop list ordering | N/A |
| **Map** | Interactive map display | `lightning-map` |
| **Publishers** | Content creation panel | N/A |
| **Setup Assistant** | Guided onboarding checklist | N/A |

---

## Framework Notes

- **LWC / Aura**: Prefer the mapped Lightning component when listed — it handles accessibility and events.
- **React / Vue / Angular / plain HTML**: Use the blueprint HTML structure and CSS classes directly.
- **Customization**: Apply styling hooks (CSS custom properties) to theme components without overriding base styles.
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