salesforce /design-system-react

Salesforce Lightning Design System for React

★ 993⑂ 444👁 39⑃ 1,920● 1,390▤ 208
JavaScriptBSD-3-ClauseCreated 2015-08-15www.chromatic.com/builds?appId=5d1452dc3b50c10020ae1bab&bran
More from this author
Download: v0.10.66v0.10.66 ↓0.10.662026-11-10
+1
Daily
993
stars
444
forks
39
watchers
1,920
prs
1,390
issues
208
releases

README

Lightning Design System _for_ React

 Accessible, localization-friendly, presentational React components

 📦 You are reading the docs for v11, which is in alpha.
 v11 is a rewrite for React 19, TypeScript, and SLDS 2. Install it with the @alpha tag; a plain npm install still gives you the stable 0.10.x release.
 Using 0.10.x? See the 0.10.x README and the 0.10.x documentation site.
 The remaining v11 work is tracked in ROADMAP.md.

 Versions

| npm tag   | Version | Branch                                                                    | React   | Styles                                    | Docs                                                                                                                                               |
| --------- | ------- | ------------------------------------------------------------------------- | ------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| @alpha  | 11.x    | master             | ^19.2   | SLDS 2 (@salesforce-ux/design-system-2) | This README, CHANGELOG.md                                                                                                          |
| @latest | 0.10.x  | 0.10.x | = 16.8 | SLDS 1 (@salesforce-ux/design-system)   | 0.10.x README, docs site |

@alpha points to v11 pre-releases. Use @latest for the latest stable release. Releases and their notes are listed on the GitHub Releases page.

v11 is not a drop-in upgrade from 0.10.x: some components were removed or renamed. See CHANGELOG.md for the breaking changes.

 Highlights

- SLDS 2 — Styled by the SLDS 2 npm package, with the Cosmos (default) and Lightning Blue themes
- Dark mode — Light, dark, and system color schemes from the SLDS 2 stylesheet
- React 19 — Function components and hooks
- TypeScript — Type definitions ship with the package
- Accessible — Built to WCAG 2.1 AA, with keyboard navigation and screen reader support

 Install

bash
npm install @salesforce/design-system-react@alpha


Without the @alpha tag, npm installs 0.10.x. Alpha releases can include breaking changes between versions, so consider pinning the exact version you tested against.

npm 7 and later also installs the peer dependencies: react, react-dom, and @salesforce-ux/design-system, which provides the icons. The stylesheet package, @salesforce-ux/design-system-2, is a regular dependency.

 Troubleshooting ERESOLVE errors

- Found: react@18…: v11 requires React 19.2 or later. Upgrade React, or stay on 0.10.x.
- Found: @salesforce-ux/design-system@…: 11.0.0-alpha.4 and earlier pin this peer dependency to exactly 2.25.0-alpha.2, so a project that already has another version fails to install. Later releases accept any 2.x version from 2.25.0-alpha.2 on. On an affected version, install with --legacy-peer-deps. That flag also skips automatic peer installs, so add React yourself:

  bash
  npm install @

Top issues

Latest release

v0.10.66 v0.10.66 2026-11-10
What's Changed
 chore:(codeowners) Add CODEOWNERS with GUSINFO by @interactivellama in https://github.com/salesforce/design-system-react/pull/3196
 fix(combobox): set aria-controls on the combobox element while open (0.10.x) by @interactivellama in https://github.com/salesforce/design-system-react/pull/3290
 fix(ci): publish 0.10.x via npm trusted publishing by @interactivellama in https://github.com/salesforce/design-system-react/pull/3293


Full Changelog: https://github.com/salesforce/design-system-react/compare/v0.10.65...v0.10.66

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON