salesforce /design-system-react
Salesforce Lightning Design System for React
★ 993⑂ 444👁 39⑃ 1,920● 1,390▤ 208
+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
#2956Datepicker: Unable to enter date manually11 comments · 2021-08-17#2643TimePicker dropdown interferes with other dropdowns11 comments · 2020-10-08#2589'No matches found' tooltip persists even after inputting item in combobox9 comments · 2020-08-17#2034Incorrect value decremented when step > minValue for counter Input8 comments · 2019-06-11#2885Popovers should focus on first focusable element when opened.7 comments · 2021-05-24#2131Align DSR Split View to SLDS7 comments · 2019-06-27#2018Modal: Focus close button on open. Fallback to wrapping container div if no close button7 comments · 2019-06-06#3127Modals not rendering when LWS security flag is active. 4 comments · 2023-08-08
Latest release
v0.10.66 v0.10.66 2026-11-10What'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