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

View on GitHub
---
id: slds.guidance.hooks.color
title: SLDS Color Styling Hooks
description: Index and decision guide for color styling hooks - semantic, system, and expressive palettes
summary: "Entry point for color styling hooks. Provides hook selection hierarchy (semantic 85%, system 5-10%, palette 5%), quick decision guide, and pointers to detailed documentation for accent, surface, feedback, system, and expressive colors."

artifact_type: index
domain: styling-hooks
topic: color

content_format: structured
complexity: intermediate
audience: [implementer]

tasks: [choose, explore]

children:
  - slds.guidance.hooks.color.accent
  - slds.guidance.hooks.color.surface
  - slds.guidance.hooks.color.feedback
  - slds.guidance.hooks.color.system
  - slds.guidance.hooks.color.expressive-palette

refs:
  - slds.guidance.hooks
  - slds.guidance.hooks.color.accent
  - slds.guidance.hooks.color.surface
  - slds.guidance.hooks.color.feedback
  - slds.guidance.hooks.color.system
  - slds.guidance.hooks.color.expressive-palette
tags: [styling-hooks, color, index, semantic, system, palette]
keywords: [color hooks, accent, surface, feedback, system colors, expressive palette, color selection]
---

# SLDS Color Styling Hooks

## Overview

SLDS color styling hooks provide a systematic approach to applying colors that maintain accessibility, support theming (including dark mode), and create consistent visual hierarchy across all Salesforce interfaces.

## Hook Selection Hierarchy

When choosing color hooks, follow this priority order:

1. **Semantic Hooks (85% of use cases)** - First choice for standard UI
2. **System Hooks (5-10%)** - Edge cases where semantic hooks don't apply
3. **Palette Hooks (5%)** - Data visualization and decorative purposes

---

## Semantic Color Hooks

Semantic hooks are purpose-driven and automatically handle accessibility and theming.

### Accent Colors

Brand identity and interactive elements like links, buttons, and icons.

**Hook patterns:** `--slds-g-color-accent-*`, `--slds-g-color-accent-container-*`, `--slds-g-color-border-accent-*`, `--slds-g-color-on-accent-*`

**Use for:** Links, brand buttons, interactive icons, selected states

> **Detailed guidance:** [Accent Color Hooks](ref:slds.guidance.hooks.color.accent)

### Surface Colors

Backgrounds and canvases that establish visual stacking context and enable theming.

**Hook patterns:** `--slds-g-color-surface-*`, `--slds-g-color-surface-container-*`, `--slds-g-color-on-surface-*`

**Use for:** Page backgrounds, modals, cards, panels, popovers

> **Detailed guidance:** [Surface Color Hooks](ref:slds.guidance.hooks.color.surface)

### Feedback Colors

Visual feedback for status and state communication.

**Hook patterns:** `--slds-g-color-error-*`, `--slds-g-color-warning-*`, `--slds-g-color-success-*`, `--slds-g-color-info-*`, `--slds-g-color-disabled-*`

**Use for:** Error messages, warnings, success confirmations, informational alerts, disabled states

> **Detailed guidance:** [Feedback Color Hooks](ref:slds.guidance.hooks.color.feedback)

---

## System Color Hooks

Direct access to brand, neutral, and feedback color palettes for edge cases.

**Hook patterns:** `--slds-g-color-neutral-base-{grade}`, `--slds-g-color-brand-base-{grade}`, `--slds-g-color-error-base-{grade}`, `--slds-g-color-warning-base-{grade}`, `--slds-g-color-success-base-{grade}`

**Use for:** Data visualization, custom brand elements, legacy migration, specialized UI

**Important:** System colors bypass built-in accessibility guarantees. Manual verification required.

> **Detailed guidance:** [System Color Hooks](ref:slds.guidance.hooks.color.system)

---

## Expressive Palette Hooks

Extended color palettes for data visualization and highlighting.

### Cool Tones (Recommended)

- **Cloud Blue:** `--slds-g-color-palette-cloud-blue-{grade}` - Professional, calm
- **Indigo:** `--slds-g-color-palette-indigo-{grade}` - Similar to brand
- **Purple:** `--slds-g-color-palette-purple-{grade}` - Expressive, creative
- **Violet:** `--slds-g-color-palette-violet-{grade}` - Accent, emphasis

### Warm Tones (Use with caution)

- **Green:** `--slds-g-color-palette-green-{grade}` - Highlights (avoid confusion with success)
- **Orange:** `--slds-g-color-palette-orange-{grade}` - Attention-grabbing
- **Hot Orange:** `--slds-g-color-palette-hot-orange-{grade}` - Maximum emphasis
- **Red:** `--slds-g-color-palette-red-{grade}` - Urgent (avoid confusion with error)

**Use for:** Charts, graphs, dashboards, data categories, infographics

> **Detailed guidance:** [Expressive Palette Hooks](ref:slds.guidance.hooks.color.expressive-palette)

---

## The Numerical Color System

SLDS uses a 0-100 grade scale where:

- **0** = Darkest
- **100** = Lightest

### Accessibility Guarantees

| Separation | Contrast Ratio | Use Case             |
| ---------- | -------------- | -------------------- |
| 50 points  | 4.5:1          | Text (WCAG AA)       |
| 40 points  | 3:1            | UI elements, borders |

### Common Pairings

| Background           | Foreground         | Purpose          |
| -------------------- | ------------------ | ---------------- |
| `surface-1`          | `on-surface-1/2/3` | Standard content |
| `accent-container-1` | `on-accent-1`      | Brand buttons    |
| `error-container-1`  | `on-error-1`       | Error alerts     |

---

## Quick Decision Guide

| Need              | Hook Category      | Example                                |
| ----------------- | ------------------ | -------------------------------------- |
| Link color        | Accent             | `--slds-g-color-accent-2`              |
| Page background   | Surface            | `--slds-g-color-surface-1`             |
| Card background   | Surface Container  | `--slds-g-color-surface-container-1`   |
| Button background | Accent Container   | `--slds-g-color-accent-container-1`    |
| Error message     | Feedback           | `--slds-g-color-error-1`               |
| Chart colors      | Expressive Palette | `--slds-g-color-palette-cloud-blue-50` |
| Body text         | On Surface         | `--slds-g-color-on-surface-2`          |

---

## Detailed Guidance

For implementation details on specific color types, see:

1. **Accent colors:** [Accent Color Hooks](ref:slds.guidance.hooks.color.accent)
2. **Surface colors:** [Surface Color Hooks](ref:slds.guidance.hooks.color.surface)
3. **Feedback colors:** [Feedback Color Hooks](ref:slds.guidance.hooks.color.feedback)
4. **System colors:** [System Color Hooks](ref:slds.guidance.hooks.color.system)
5. **Expressive palette:** [Expressive Palette Hooks](ref:slds.guidance.hooks.color.expressive-palette)
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