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/illustration.yaml

View on GitHub
name: "Illustration"

description: "Visual illustrations used for empty states, error states, or informational contexts. Provides scalable SVG graphics with consistent styling and themeable colors for strokes and fills."

category: "Display"

slds_classes:
  root: "slds-illustration"
  elements:
    - class: "slds-illustration__svg"
      description: "SVG container for the illustration graphic"
      purpose: "Holds the SVG illustration image"
    - class: "slds-illustration__header"
      description: "Header text above the illustration"
      purpose: "Provides title or main message"
    - class: "slds-illustration__stroke-primary"
      description: "Primary stroke color for SVG elements"
      purpose: "Applied to SVG paths for consistent theming"
    - class: "slds-illustration__stroke-secondary"
      description: "Secondary stroke color for SVG elements"
      purpose: "Applied to SVG paths for accent colors"
    - class: "slds-illustration__fill-primary"
      description: "Primary fill color for SVG elements"
      purpose: "Applied to SVG shapes for consistent theming"
    - class: "slds-illustration__fill-secondary"
      description: "Secondary fill color for SVG elements"
      purpose: "Applied to SVG shapes for accent colors"
  modifiers:
    - class: "slds-illustration_small"
      description: "Small size variant (300x200px max)"
      purpose: "Compact illustration for smaller spaces"
    - class: "slds-illustration_large"
      description: "Large size variant (600x400px max)"
      purpose: "Full-size illustration for prominent empty states"
  states: []

variants:
  - name: "Base"
    description: "Standard illustration with default sizing"
    classes: ["slds-illustration"]
    usage_context: "Default illustration implementation"
    differences: "Responsive illustration with natural SVG sizing"
  - name: "Small"
    description: "Compact illustration for smaller contexts"
    classes: ["slds-illustration", "slds-illustration_small"]
    usage_context: "Use in panels, cards, or compact layouts"
    differences: "Maximum 300x200px with reduced spacing"
  - name: "Large"
    description: "Full-size illustration for prominent display"
    classes: ["slds-illustration", "slds-illustration_large"]
    usage_context: "Use for main content area empty states"
    differences: "Maximum 600x400px with increased spacing"

lightning_component:
  name: ""
  url: "https://developer.salesforce.com/docs/component-library/overview/components"
  mapping_notes: "No direct Lightning Base Component - implement with custom SVG and styling"

accessibility:
  keyboard_support:
    - "Illustrations are typically non-interactive"
  screen_reader:
    - "Provide descriptive alt text or aria-label"
    - "Use aria-hidden='true' for decorative illustrations"
    - "Ensure accompanying text is accessible"
  aria_attributes:
    - "role='img' on SVG or wrapper"
    - "aria-label with description for meaningful illustrations"
    - "aria-hidden='true' for purely decorative images"

usage_guidelines:
  when_to_use:
    - "For empty states (no data, no results, no items)"
    - "For error or success confirmation screens"
    - "To communicate system status visually"
    - "For onboarding or informational screens"
  when_not_to_use:
    - "As primary content (use as supporting visual)"
    - "For critical information without text backup"
    - "In place of icons for actions"
    - "When space is extremely limited"
  best_practices:
    - "Always pair illustration with descriptive text"
    - "Use appropriate size variant for context"
    - "Provide clear messaging about user action or state"
    - "Ensure illustrations support but don't replace text"
    - "Use consistent illustration style across application"
    - "Consider color contrast and visibility"
  common_mistakes:
    - "Missing descriptive text or heading"
    - "Illustrations too large for context"
    - "Poor color contrast making illustration hard to see"
    - "Relying solely on illustration without text"
    - "Using wrong size variant for space available"

code_examples:
  - title: "Basic Illustration with Empty State"
    code: |
      <div class="slds-illustration slds-illustration_small">
        <svg class="slds-illustration__svg" viewBox="0 0 468 194" aria-hidden="true">
          <g class="slds-illustration__stroke-primary">
            <path d="M233.9 87.3l14.6 36.9 39.6 5.8-28.6 27.9 6.8 39.3-35.5-18.6-35.4 18.6 6.7-39.3L174 130l39.6-5.8z"/>
          </g>
          <g class="slds-illustration__fill-secondary">
            <path d="M234 180.5l-22.7-11.9 4.3 25.2 18.4-13.3z"/>
          </g>
        </svg>
        <h3 class="slds-illustration__header">No Items Found</h3>
        <p class="slds-text-body_regular">Start by creating your first item.</p>
      </div>
    description: "Small illustration for empty state with header and description"
  - title: "Large Illustration with Action"
    code: |
      <div class="slds-illustration slds-illustration_large">
        <svg class="slds-illustration__svg" viewBox="0 0 600 400" aria-hidden="true">
          <g class="slds-illustration__stroke-primary">
            <rect x="100" y="100" width="400" height="200" rx="8"/>
          </g>
          <g class="slds-illustration__fill-secondary">
            <circle cx="300" cy="200" r="50"/>
          </g>
        </svg>
        <h3 class="slds-illustration__header">Welcome to Your Dashboard</h3>
        <p class="slds-text-body_regular">Get started by adding your first widget.</p>
        <button class="slds-button slds-button_brand">Add Widget</button>
      </div>
    description: "Large illustration with header, description, and action button"
  - title: "Illustration with No Data State"
    code: |
      <div class="slds-illustration slds-illustration_small">
        <svg class="slds-illustration__svg" viewBox="0 0 300 200" aria-hidden="true">
          <g class="slds-illustration__fill-primary">
            <path d="M150 50 L250 150 L50 150 Z"/>
          </g>
          <g class="slds-illustration__stroke-secondary">
            <line x1="150" y1="70" x2="150" y2="130" stroke-width="3"/>
            <line x1="130" y1="150" x2="170" y2="150" stroke-width="3"/>
          </g>
        </svg>
        <div class="slds-text-longform">
          <h3 class="slds-illustration__header slds-text-heading_medium">
            No Records to Display
          </h3>
          <p class="slds-text-body_regular">
            When you have records, they'll appear here.
          </p>
        </div>
      </div>
    description: "Illustration communicating no data available"
  - title: "Error State Illustration"
    code: |
      <div class="slds-illustration slds-illustration_small">
        <svg class="slds-illustration__svg" viewBox="0 0 300 200" role="img" aria-labelledby="error-title">
          <title id="error-title">Error occurred</title>
          <g class="slds-illustration__stroke-primary">
            <circle cx="150" cy="100" r="40" fill="none" stroke-width="3"/>
            <line x1="130" y1="80" x2="170" y2="120" stroke-width="3"/>
            <line x1="170" y1="80" x2="130" y2="120" stroke-width="3"/>
          </g>
        </svg>
        <h3 class="slds-illustration__header">Something Went Wrong</h3>
        <p class="slds-text-body_regular">
          We couldn't complete your request. Please try again.
        </p>
        <button class="slds-button slds-button_neutral">Try Again</button>
      </div>
    description: "Error state illustration with retry action"

styling_hooks:
  - name: "--slds-g-color-palette-cloud-blue-80"
    description: "Primary color for illustration strokes and fills"
    css_property: "stroke, fill"
  - name: "--slds-g-color-palette-cloud-blue-90"
    description: "Secondary color for illustration strokes and fills"
    css_property: "stroke, fill"

dependencies:
  css_files: ["illustration.css"]
  javascript: []
  icons: []
  other_components: ["button", "text"]

related_components:
  - name: "Empty State"
    relationship: "pattern"
    description: "Complete pattern using illustration"
  - name: "Icon"
    relationship: "alternative"
    description: "Simpler graphic alternative for smaller contexts"
  - name: "Spinner"
    relationship: "complementary"
    description: "Loading state while content loads"

references:
  official_docs: "https://v1.lightningdesignsystem.com/components/illustration/"

metadata:
  version: "1.0.0"
  last_updated: "2025-11-11"
  author: "SLDS Documentation Team"
  slds_version: "2.27.2"
  review_status: "complete"
  source: "official-slds"
  notes: "Created from official SLDS documentation and design-system-internal source code"

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