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/color.md

View on GitHub
---
id: slds.guidance.utilities.color
title: Color Utilities
description: SLDS color utility classes for text, background, border, and fill properties
summary: "Utilities for applying neutral gray colors. Includes text, background, border, and fill classes across a 12-step neutral palette."

artifact_type: reference
domain: utilities
topic: color

content_format: structured
complexity: intermediate
audience: [implementer]

tasks: [implement]

refs:
  - slds.guidance.utilities
  - slds.guidance.overview.utilities
  - slds.guidance.hooks.color

tags: [utilities, color, neutral-palette, accessibility]
keywords: [slds-color, text-gray, background-gray, border-gray, fill-gray]
---

# Color - Neutral Palette

Utilities for applying neutral gray colors to text, backgrounds, borders, and SVG fills.

## Core Classes

### Text Colors

| Class | Purpose | Token Value |
|-------|---------|-------------|
| `slds-color__text_gray-1` | Apply lightest gray text color | `--slds-g-color-neutral-base-100` |
| `slds-color__text_gray-2` | Apply gray-2 text color | `--slds-g-color-neutral-base-95` |
| `slds-color__text_gray-3` | Apply gray-3 text color | `--slds-g-color-neutral-base-95` |
| `slds-color__text_gray-4` | Apply gray-4 text color | `--slds-g-color-neutral-base-90` |
| `slds-color__text_gray-5` | Apply gray-5 text color | `--slds-g-color-neutral-base-90` |
| `slds-color__text_gray-6` | Apply gray-6 text color | `--slds-g-color-neutral-base-80` |
| `slds-color__text_gray-7` | Apply gray-7 text color | `--slds-g-color-neutral-base-70` |
| `slds-color__text_gray-8` | Apply gray-8 text color | `--slds-g-color-neutral-base-60` |
| `slds-color__text_gray-9` | Apply gray-9 text color | `--slds-g-color-neutral-base-50` |
| `slds-color__text_gray-10` | Apply gray-10 text color | `--slds-g-color-neutral-base-30` |
| `slds-color__text_gray-11` | Apply gray-11 text color | `--slds-g-color-neutral-base-30` |
| `slds-color__text_gray-12` | Apply darkest gray text color | `--slds-g-color-neutral-base-20` |

### Background Colors

| Class | Purpose | Token Value |
|-------|---------|-------------|
| `slds-color__background_gray-1` | Apply lightest gray background | `--slds-g-color-neutral-base-100` |
| `slds-color__background_gray-2` | Apply gray-2 background | `--slds-g-color-neutral-base-95` |
| `slds-color__background_gray-3` | Apply gray-3 background | `--slds-g-color-neutral-base-95` |
| `slds-color__background_gray-4` | Apply gray-4 background | `--slds-g-color-neutral-base-90` |
| `slds-color__background_gray-5` | Apply gray-5 background | `--slds-g-color-neutral-base-90` |
| `slds-color__background_gray-6` | Apply gray-6 background | `--slds-g-color-neutral-base-80` |
| `slds-color__background_gray-7` | Apply gray-7 background | `--slds-g-color-neutral-base-70` |
| `slds-color__background_gray-8` | Apply gray-8 background | `--slds-g-color-neutral-base-60` |
| `slds-color__background_gray-9` | Apply gray-9 background | `--slds-g-color-neutral-base-50` |
| `slds-color__background_gray-10` | Apply gray-10 background | `--slds-g-color-neutral-base-30` |
| `slds-color__background_gray-11` | Apply gray-11 background | `--slds-g-color-neutral-base-30` |
| `slds-color__background_gray-12` | Apply darkest gray background | `--slds-g-color-neutral-base-20` |

### Border Colors

| Class | Purpose | Token Value |
|-------|---------|-------------|
| `slds-color__border_gray-1` | Apply lightest gray border | `--slds-g-color-neutral-base-100` |
| `slds-color__border_gray-2` | Apply gray-2 border | `--slds-g-color-neutral-base-95` |
| `slds-color__border_gray-3` | Apply gray-3 border | `--slds-g-color-neutral-base-95` |
| `slds-color__border_gray-4` | Apply gray-4 border | `--slds-g-color-neutral-base-90` |
| `slds-color__border_gray-5` | Apply gray-5 border | `--slds-g-color-neutral-base-90` |
| `slds-color__border_gray-6` | Apply gray-6 border | `--slds-g-color-neutral-base-80` |
| `slds-color__border_gray-7` | Apply gray-7 border | `--slds-g-color-neutral-base-70` |
| `slds-color__border_gray-8` | Apply gray-8 border | `--slds-g-color-neutral-base-60` |
| `slds-color__border_gray-9` | Apply gray-9 border | `--slds-g-color-neutral-base-50` |
| `slds-color__border_gray-10` | Apply gray-10 border | `--slds-g-color-neutral-base-30` |
| `slds-color__border_gray-11` | Apply gray-11 border | `--slds-g-color-neutral-base-30` |
| `slds-color__border_gray-12` | Apply darkest gray border | `--slds-g-color-neutral-base-20` |

### SVG Fill Colors

| Class | Purpose | Token Value |
|-------|---------|-------------|
| `slds-color__fill_gray-1` | Apply lightest gray SVG fill | `--slds-g-color-neutral-base-100` |
| `slds-color__fill_gray-2` | Apply gray-2 SVG fill | `--slds-g-color-neutral-base-95` |
| `slds-color__fill_gray-3` | Apply gray-3 SVG fill | `--slds-g-color-neutral-base-95` |
| `slds-color__fill_gray-4` | Apply gray-4 SVG fill | `--slds-g-color-neutral-base-90` |
| `slds-color__fill_gray-5` | Apply gray-5 SVG fill | `--slds-g-color-neutral-base-90` |
| `slds-color__fill_gray-6` | Apply gray-6 SVG fill | `--slds-g-color-neutral-base-80` |
| `slds-color__fill_gray-7` | Apply gray-7 SVG fill | `--slds-g-color-neutral-base-70` |
| `slds-color__fill_gray-8` | Apply gray-8 SVG fill | `--slds-g-color-neutral-base-60` |
| `slds-color__fill_gray-9` | Apply gray-9 SVG fill | `--slds-g-color-neutral-base-50` |
| `slds-color__fill_gray-10` | Apply gray-10 SVG fill | `--slds-g-color-neutral-base-30` |
| `slds-color__fill_gray-11` | Apply gray-11 SVG fill | `--slds-g-color-neutral-base-30` |
| `slds-color__fill_gray-12` | Apply darkest gray SVG fill | `--slds-g-color-neutral-base-20` |

## Common Patterns

### Card with Neutral Background
```html
<!-- Card with gray-2 background and darker text -->
<div class="slds-card slds-color__background_gray-2 slds-p-around_medium">
  <h2 class="slds-text-heading_medium slds-color__text_gray-12">Card Title</h2>
  <p class="slds-color__text_gray-10">Card content with readable contrast</p>
</div>
```

### Status Indicator with Border
```html
<!-- Status box with colored border -->
<div class="slds-box slds-color__border_gray-7 slds-border_top slds-border_bottom">
  <span class="slds-color__text_gray-9">Pending Review</span>
</div>
```

### Icon with Custom Fill Color
```html
<!-- SVG icon with gray fill -->
<svg class="slds-icon slds-icon_small slds-color__fill_gray-8">
  <use xlink:href="/assets/icons/utility-sprite/svg/symbols.svg#info"></use>
</svg>
```

### Alternating Row Colors
```html
<!-- Table rows with alternating backgrounds -->
<table class="slds-table">
  <tbody>
    <tr class="slds-color__background_gray-1">
      <td>Row 1 with gray-1 background</td>
    </tr>
    <tr class="slds-color__background_gray-2">
      <td>Row 2 with gray-2 background</td>
    </tr>
  </tbody>
</table>
```

### Text Hierarchy with Gray Scale
```html
<!-- Content with visual hierarchy using grays -->
<article class="slds-card__body">
  <h3 class="slds-color__text_gray-12">Primary Heading</h3>
  <h4 class="slds-color__text_gray-10">Secondary Heading</h4>
  <p class="slds-color__text_gray-8">Body text content</p>
  <small class="slds-color__text_gray-6">Supporting metadata</small>
</article>
```

## Best Practices

✅ Maintain WCAG AA contrast ratio of 4.5:1 for normal text
✅ Maintain WCAG AA contrast ratio of 3:1 for large text (18pt or 14pt bold)
✅ Use `slds-color__text_gray-12` on light backgrounds for maximum readability
✅ Use `slds-color__text_gray-1` on dark backgrounds for maximum readability
✅ Test color combinations with accessibility tools before deployment
✅ Use consistent gray levels across similar UI elements

❌ Never use gray-1 through gray-5 text on white backgrounds (insufficient contrast)
❌ Avoid using similar gray values for foreground and background
❌ Never rely solely on color to convey information
❌ Avoid using `slds-color__text_gray-6` or lighter for body text
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