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

View on GitHub
name: "Accordion"
description: "A vertically stacked list of items where only one item is shown at a time. When a new item is clicked, it expands to reveal its content and the previously open item closes. Each accordion consists of multiple sections with collapsible content areas and clickable headers."
category: "Layout"
slds_classes:
  root: "slds-accordion"
  elements:
    - class: "slds-accordion__list-item"
      description: "Container for each accordion section"
      purpose: "Wraps individual accordion items"
    - class: "slds-accordion__section"
      description: "Individual section within the accordion"
      purpose: "Contains a single collapsible section with header and content"
    - class: "slds-accordion__summary"
      description: "Clickable header area for each accordion section"
      purpose: "Contains the accordion toggle button and summary content"
    - class: "slds-accordion__summary-heading"
      description: "Heading container within the summary"
      purpose: "Contains the text heading for the accordion section"
    - class: "slds-accordion__summary-content"
      description: "Content area within the summary"
      purpose: "Contains the section title and description"
    - class: "slds-accordion__summary-action"
      description: "Action area within the summary"
      purpose: "Contains buttons or interactive elements in the summary"
    - class: "slds-accordion__summary-action-icon"
      description: "Icon for expand/collapse action"
      purpose: "Visual indicator for section state and interaction"
    - class: "slds-accordion__content"
      description: "Collapsible content area of each accordion section"
      purpose: "Contains the main content that expands/collapses"
  modifiers:
    - class: "slds-is-open"
      description: "Applied to accordion section when expanded"
      usage: "Toggle on/off to control accordion section state"
  states:
    - class: "slds-is-open"
      description: "Expanded state for accordion sections"
      trigger: "User interaction with summary button"
    - class: "slds-is-closed"
      description: "Collapsed section state"
      trigger: "Applied when accordion section is collapsed"
variants:
  - name: "Base"
    description: "Standard accordion with expandable sections"
    classes:
      - "slds-accordion"
    usage_context: "Default implementation for collapsible content sections"
    differences: "Single accordion with multiple collapsible sections"
lightning_component:
  name: "lightning-accordion"
  url: "https://developer.salesforce.com/docs/component-library/bundle/lightning-accordion"
  mapping_notes: "Direct mapping - Lightning component implements SLDS accordion blueprint. Individual sections map to lightning-accordion-section components."
accessibility:
  keyboard_support:
    - "Tab to navigate between accordion sections"
    - "Enter/Space to expand/collapse sections"
    - "Arrow keys may be used for section navigation"
    - "Focus management within expanded content"
  screen_reader:
    - "Announces section state (expanded/collapsed)"
    - "Provides context about accordion content"
    - "Section purpose and state announced"
    - "Expansion state changes communicated"
    - "Content structure properly conveyed"
  aria_attributes:
    - "aria-expanded on summary elements"
    - "aria-controls linking summary to content"
    - "role='button' on interactive summary elements"
    - "aria-labelledby for content labeling"
    - "role='region' for content areas"
usage_guidelines:
  when_to_use:
    - "When you have multiple sections of content that users might not need to see all at once"
    - "To save vertical space on a page"
    - "For FAQ sections or help documentation"
    - "When content can be logically grouped into sections"
    - "For organizing related content that can be shown/hidden"
    - "When content hierarchy needs progressive disclosure"
  when_not_to_use:
    - "When all content should be visible simultaneously"
    - "For navigation menus (use navigation components instead)"
    - "When sections are very small and wouldn't benefit from collapsing"
    - "For unrelated content groupings"
  best_practices:
    - "Use clear, descriptive headings for each section"
    - "Keep section headings concise"
    - "Ensure content within sections is meaningful when collapsed"
    - "Provide visual indicators for expanded/collapsed states"
    - "Group related content logically"
    - "Provide meaningful content in each section"
    - "Consider default expanded/collapsed states"
    - "Maintain consistent section behavior"
  common_mistakes:
    - "Making section headings too vague"
    - "Overusing accordions where tabbed interfaces would be better"
    - "Not providing proper ARIA attributes for accessibility"
    - "Using unclear or generic section titles"
    - "Putting too much content in individual sections"
    - "Inconsistent section behavior"
    - "Poor content organization within sections"
code_examples:
  - title: "Basic Accordion"
    description: "Standard accordion with single section"
    code: |
      <div class="slds-accordion">
            <section class="slds-accordion__list-item">
              <div class="slds-accordion__summary" id="accordion-summary-01">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-button slds-button_reset slds-accordion__summary-action" aria-controls="accordion-content-01" aria-expanded="true">
                    <span class="slds-accordion__summary-content">Accordion summary</span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content slds-is-open" id="accordion-content-01">
                <p>Accordion content</p>
              </div>
            </section>
            </div>
  - title: "Multi-Section Accordion"
    description: "Complete accordion with multiple expandable sections"
    code: |
      <div class="slds-accordion">
            <section class="slds-accordion__section slds-is-open">
              <div class="slds-accordion__summary">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-accordion__summary-action slds-button slds-button_reset" aria-controls="accordion-details-01" aria-expanded="true">
                    <svg class="slds-accordion__summary-action-icon slds-button__icon slds-button__icon_left" aria-hidden="true">
                      <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#switch"></use>
                    </svg>
                    <span class="slds-accordion__summary-content">
                      Getting Started
                    </span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content" id="accordion-details-01">
                <p>This section contains information about getting started with our platform. You'll find step-by-step instructions, helpful tips, and links to additional resources.</p>
                <ul class="slds-list_dotted">
                  <li>Create your account</li>
                  <li>Complete your profile</li>
                  <li>Explore the dashboard</li>
                  <li>Take the guided tour</li>
                </ul>
              </div>
            </section>
            <section class="slds-accordion__section slds-is-closed">
              <div class="slds-accordion__summary">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-accordion__summary-action slds-button slds-button_reset" aria-controls="accordion-details-02" aria-expanded="false">
                    <svg class="slds-accordion__summary-action-icon slds-button__icon slds-button__icon_left" aria-hidden="true">
                      <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#switch"></use>
                    </svg>
                    <span class="slds-accordion__summary-content">
                      Advanced Features
                    </span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content slds-hide" id="accordion-details-02">
                <p>Learn about our advanced features and how to use them effectively in your workflow.</p>
              </div>
            </section>
            <section class="slds-accordion__section slds-is-open">
              <div class="slds-accordion__summary">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-accordion__summary-action slds-button slds-button_reset" aria-controls="accordion-details-03" aria-expanded="true">
                    <svg class="slds-accordion__summary-action-icon slds-button__icon slds-button__icon_left" aria-hidden="true">
                      <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#switch"></use>
                    </svg>
                    <span class="slds-accordion__summary-content">
                      Account Settings
                    </span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content" id="accordion-details-03">
                <div class="slds-grid slds-wrap">
                  <div class="slds-col slds-size_1-of-1 slds-medium-size_1-of-2">
                    <h4 class="slds-text-heading_small slds-m-bottom_small">Profile Information</h4>
                    <ul class="slds-list_vertical">
                      <li class="slds-list__item">Update your name and contact details</li>
                      <li class="slds-list__item">Change your profile picture</li>
                      <li class="slds-list__item">Manage privacy settings</li>
                    </ul>
                  </div>
                  <div class="slds-col slds-size_1-of-1 slds-medium-size_1-of-2">
                    <h4 class="slds-text-heading_small slds-m-bottom_small">Security</h4>
                    <ul class="slds-list_vertical">
                      <li class="slds-list__item">Change your password</li>
                      <li class="slds-list__item">Enable two-factor authentication</li>
                      <li class="slds-list__item">Review login activity</li>
                    </ul>
                  </div>
                </div>
              </div>
            </section>
            </div>
  - title: "FAQ Accordion"
    description: "Accordion optimized for frequently asked questions"
    code: |
      <div class="slds-accordion">
            <section class="slds-accordion__section slds-is-closed">
              <div class="slds-accordion__summary">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-accordion__summary-action slds-button slds-button_reset" aria-controls="faq-01" aria-expanded="false">
                    <svg class="slds-accordion__summary-action-icon slds-button__icon slds-button__icon_left" aria-hidden="true">
                      <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#switch"></use>
                    </svg>
                    <span class="slds-accordion__summary-content">
                      How do I reset my password?
                    </span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content slds-hide" id="faq-01">
                <p>To reset your password:</p>
                <ol class="slds-list_ordered">
                  <li>Click the "Forgot Password" link on the login page</li>
                  <li>Enter your email address</li>
                  <li>Check your email for reset instructions</li>
                  <li>Follow the link and create a new password</li>
                </ol>
              </div>
            </section>
            <section class="slds-accordion__section slds-is-closed">
              <div class="slds-accordion__summary">
                <h3 class="slds-accordion__summary-heading">
                  <button class="slds-accordion__summary-action slds-button slds-button_reset" aria-controls="faq-02" aria-expanded="false">
                    <svg class="slds-accordion__summary-action-icon slds-button__icon slds-button__icon_left" aria-hidden="true">
                      <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#switch"></use>
                    </svg>
                    <span class="slds-accordion__summary-content">
                      Where can I find my billing information?
                    </span>
                  </button>
                </h3>
              </div>
              <div class="slds-accordion__content slds-hide" id="faq-02">
                <p>Your billing information can be found in the Account Settings section under "Billing & Payments". From there you can:</p>
                <ul class="slds-list_dotted">
                  <li>View current charges</li>
                  <li>Download invoices</li>
                  <li>Update payment methods</li>
                  <li>Change billing addresses</li>
                </ul>
              </div>
            </section>
            </div>
styling_hooks:
  - name: "--slds-c-accordion-heading-color"
    description: "Text color for accordion headings"
    category: "color"
  - name: "--slds-c-accordion-heading-font-size"
    description: "Font size for accordion headings"
    category: "typography"
  - name: "--slds-c-accordion-section-color-border"
    description: "Border color for accordion sections"
    category: "color"
  - name: "--slds-c-accordion-section-sizing-border"
    description: "Border width for accordion sections"
    category: "sizing"
  - name: "--slds-c-accordion-section-spacing-block-end"
    description: "Bottom spacing for accordion sections"
    category: "spacing"
  - name: "--slds-c-accordion-section-spacing-block-start"
    description: "Top spacing for accordion sections"
    category: "spacing"
  - name: "--slds-c-accordion-section-spacing-inline-end"
    description: "Right spacing for accordion sections"
    category: "spacing"
  - name: "--slds-c-accordion-section-spacing-inline-start"
    description: "Left spacing for accordion sections"
    category: "spacing"
  - name: "--slds-c-accordion-summary-color-background"
    description: "Background color for accordion summary"
    category: "color"
dependencies:
  css_files:
    - "accordion.css"
    - "button.css"
  javascript:
    - "accordion.js"
  icons:
    - "utility-sprite.svg"
  other_components:
    - "button"
related_components:
  - name: "Expandable Section"
    relationship: "similar"
    description: "Single expandable section, simpler alternative"
  - name: "Tabs"
    relationship: "alternative"
    description: "Alternative for organizing content sections"
  - name: "Summary Detail"
    relationship: "similar"
    description: "Similar progressive disclosure pattern"
references:
  official_docs: "https://v1.lightningdesignsystem.com/components/accordion/"
metadata:
  version: "2.0.0"
  last_updated: "2025-11-12"
  review_status: "complete"
  merge_notes: "Merged accordion-section.yaml into unified accordion blueprint for SLDS architectural accuracy"
  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