salesforce-ux/design-system

This repository contains the source code for the Salesforce Lightning Design System, commonly called SLDS. It is a collection of CSS styles, HTML patterns, and visual components that developers use when building applications on the Salesforce platform. The goal is straightforward: any app built with these styles will automatically look and behave like a native Salesforce product, matching the visual language that Salesforce users already know. The system keeps itself current as Salesforce updates its own interface. If a developer uses the latest version of this design system, their app's pages stay in sync with Salesforce's own UI changes without requiring manual adjustments. This matters because Salesforce updates its visual design periodically, and manually chasing those changes would be tedious. For developers working on the code itself, the project uses Storybook, a tool that displays individual UI components in isolation so they can be built and tested without running a full application. Starting the development environment requires Node.js version 14 and a few standard command-line steps: install dependencies with npm, then run npm start to open Storybook in a browser. The repository includes tools for checking code quality across several areas: CSS and Sass style rules, JavaScript formatting, HTML validity, and accessibility compliance. A separate build step compiles the Sass source files into finished CSS and packages everything into a distributable folder for use in real projects. There are also test commands covering both general functionality and accessibility audits. The source code is available under a BSD 3-Clause license, while the icons and image assets use a Creative Commons license that permits use but not modification. Feedback and contributions are handled through GitHub issues and a contributing guide included in the repository.