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

assets/blueprints/components/buttons.yaml

View on GitHub
name: Buttons
description: Clickable elements used to perform actions. Buttons communicate action and direct user intent.
category: Actions
slds_classes:
  root: slds-button
  elements:
  - class: slds-button__icon
    description: Icon within button
    purpose: Contains SVG icons inside buttons
  - class: slds-button__icon_left
    description: Icon positioned on the left side of button text
    purpose: Positions icon to the left of button label
  - class: slds-button__icon_right
    description: Icon positioned on the right side of button text
    purpose: Positions icon to the right of button label
  modifiers:
  - class: slds-button_neutral
    description: Default button style with neutral appearance
    usage: Use for secondary actions or when multiple buttons are present
  - class: slds-button_brand
    description: Primary button style with brand color
    usage: Use for primary actions, limit to one per page section
  - class: slds-button_outline-brand
    description: Button with brand-colored outline
    usage: Use for secondary actions that need more emphasis than neutral
  - class: slds-button_destructive
    description: Button for destructive actions
    usage: Use for delete, remove, or other potentially harmful actions
  - class: slds-button_text-destructive
    description: Text-only destructive button
    usage: Use for destructive actions that need less visual weight
  - class: slds-button_success
    description: Button for successful or positive actions
    usage: Use for confirm, save, or other positive actions
  - class: slds-button_inverse
    description: Button for use on dark backgrounds
    usage: Use when button appears on dark or colored backgrounds
  - class: slds-button_icon
    description: Icon-only button base class
    usage: Use for buttons containing only icons
  - class: slds-button_icon-bare
    description: Icon button with no border or background
    usage: Use for minimal icon buttons
  - class: slds-button_icon-container
    description: Icon button with container styling
    usage: Use for icon buttons that need visual containment
  - class: slds-button_icon-border
    description: Icon button with border
    usage: Use for icon buttons that need border definition
  - class: slds-button_icon-border-filled
    description: Icon button with border and background fill
    usage: Use for icon buttons that need filled appearance
  - class: slds-button_icon-more
    description: Icon button styled for 'more actions' pattern
    usage: Use specifically for overflow menu triggers
  sizes:
  - class: slds-button_small
    description: Small button size
    usage: Use when default size is too large
  states:
  - class: slds-is-selected
    description: Selected state for stateful buttons
    trigger: User selection or programmatic state change
  - class: slds-not-selected
    description: Not selected state for stateful buttons
    trigger: Default or deselected state
variants:
- name: Base
  description: Standard button styles including neutral, brand, and destructive variants
  classes:
  - slds-button
  - slds-button_neutral
  - slds-button_brand
  usage_context: Default buttons for actions throughout the interface
  differences: Different visual emphasis levels for action hierarchy
- name: Icon
  description: Icon-only buttons in various styles
  classes:
  - slds-button
  - slds-button_icon
  - slds-button_icon-border
  usage_context: When space is constrained or action is universally understood
  differences: No text labels, rely on iconography for meaning
- name: Stateful
  description: Buttons that toggle between states
  classes:
  - slds-button
  - slds-is-selected
  - slds-not-selected
  usage_context: For toggle actions like favorites, follow, or selection
  differences: Visual state changes based on user interaction
lightning_component:
  name: lightning-button
  url: https://developer.salesforce.com/docs/component-library/bundle/lightning-button
  mapping_notes: Direct mapping - Lightning component implements SLDS button blueprint with additional functionality
accessibility:
  keyboard_support:
  - Tab to focus on button
  - Enter or Space to activate button
  - Focus visible indicators required
  screen_reader:
  - Button text or aria-label announced
  - Button role automatically conveyed
  - State changes announced for stateful buttons
  aria_attributes:
  - aria-label for icon-only buttons
  - aria-pressed for stateful toggle buttons
  - aria-describedby for additional context
  - aria-disabled for disabled state
usage_guidelines:
  when_to_use:
  - To trigger an action or event
  - To submit forms
  - To navigate to a new page or section
  - To open modals or dialogs
  when_not_to_use:
  - For navigation use links instead
  - When the action is not immediately actionable
  - For decorative purposes
  best_practices:
  - Use clear, action-oriented labels
  - Maintain visual hierarchy with button types
  - Limit primary buttons to one per section
  - Group related buttons logically
  - Ensure sufficient spacing between buttons
  common_mistakes:
  - Using multiple primary buttons in the same area
  - Making button labels too vague
  - Not providing sufficient color contrast
  - Overusing destructive button styling
code_examples:
- title: Basic Button Variants
  code: "<button class=\"slds-button slds-button_neutral\">Neutral Button</button>\n      <button class=\"slds-button slds-button_brand\"\
    >Brand Button</button>\n      <button class=\"slds-button slds-button_destructive\">Destructive Button</button>\n"
- title: Button with Icons
  code: "<button class=\"slds-button slds-button_neutral\">\n      <svg class=\"slds-button__icon slds-button__icon_left\"\
    \ aria-hidden=\"true\">\n        <use xlink:href=\"/assets/icons/utility-sprite/svg/symbols.svg#download\"></use>\n  \
    \    </svg>\n      Download\n      </button>\n"
- title: Icon Only Button
  code: "<button class=\"slds-button slds-button_icon slds-button_icon-border\" aria-label=\"Settings\">\n      <svg class=\"\
    slds-button__icon\" aria-hidden=\"true\">\n        <use xlink:href=\"/assets/icons/utility-sprite/svg/symbols.svg#settings\"\
    ></use>\n      </svg>\n      </button>\n"
- title: Stateful Button
  code: "<button class=\"slds-button slds-button_icon slds-button_icon-border slds-is-selected\" aria-pressed=\"true\" aria-label=\"\
    Like this item\">\n      <svg class=\"slds-button__icon\" aria-hidden=\"true\">\n        <use xlink:href=\"/assets/icons/utility-sprite/svg/symbols.svg#like\"\
    ></use>\n      </svg>\n      </button>\n"
styling_hooks:
- name: --slds-c-button-brand-color-background
  description: Background color for brand buttons
  category: color
- name: --slds-c-button-brand-color-background-hover
  description: Background color for brand buttons on hover
  category: color
- name: --slds-c-button-brand-color-background-active
  description: Background color for brand buttons when active
  category: color
- name: --slds-c-button-brand-color-border
  description: Border color for brand buttons
  category: color
- name: --slds-c-button-brand-text-color
  description: Text color for brand buttons
  category: color
- name: --slds-c-button-neutral-color-background
  description: Background color for neutral buttons
  category: color
- name: --slds-c-button-neutral-color-background-hover
  description: Background color for neutral buttons on hover
  category: color
- name: --slds-c-button-neutral-color-background-active
  description: Background color for neutral buttons when active
  category: color
- name: --slds-c-button-neutral-color-border
  description: Border color for neutral buttons
  category: color
- name: --slds-c-button-destructive-color-background
  description: Background color for destructive buttons
  category: color
- name: --slds-c-button-destructive-color-background-hover
  description: Background color for destructive buttons on hover
  category: color
- name: --slds-c-button-destructive-color-border
  description: Border color for destructive buttons
  category: color
- name: --slds-c-button-success-color-background
  description: Background color for success buttons
  category: color
- name: --slds-c-button-success-color-background-hover
  description: Background color for success buttons on hover
  category: color
- name: --slds-c-button-success-color-border
  description: Border color for success buttons
  category: color
- name: --slds-c-button-spacing-inline
  description: Horizontal padding for buttons
  category: spacing
- name: --slds-c-button-font-weight
  description: Font weight for button text
  category: typography
- name: --slds-c-button-radius-border
  description: Border radius for buttons
  category: border
- name: --slds-c-button-sizing-border
  description: Border width for buttons
  category: sizing
dependencies:
  css_files:
  - buttons.css
  javascript: []
  icons:
  - utility-sprite.svg (for icon buttons)
  other_components:
  - button-groups
  - button-icons
related_components:
- name: Button Groups
  relationship: container
  description: Groups multiple buttons together
- name: Button Icons
  relationship: variant
  description: Icon-only button implementations
- name: Menus
  relationship: trigger
  description: Buttons often trigger dropdown menus
references:
  official_docs: https://v1.lightningdesignsystem.com/components/buttons/
metadata:
  version: 1.0.0
  last_updated: '2025-11-12'
  review_status: complete
  notes: ' Cleaned invalid classes and CSS variables on 2025-11-12 using slds-plus.css as source of truth.'
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