U.S. Web Design System
Public domain library of user interface components, CSS, JavaScript and a visual style guide designed for U.S. federal government websites.
designsystem.digital.govrepositorydocs
U.S. Web Design System is a library of user interface components, a CSS stylesheet and JavaScript, built from Sass source, for U.S. federal government websites. A project installs the @uswds/uswds npm package or downloads the release archive, then either links the precompiled files or compiles its own stylesheet from the Sass source. The component templates in the source are written in Twig.
Worth knowing
The project is in the public domain, but some icons, fonts and normalize files in it keep their own open source licenses, which travel with copies of those parts. Customizing the JavaScript needs Node.js and a module bundler.
Identity
Rendering and deploy
- Install with
- npm7
Releases
Adoption
Sources
- 2026-10-28: links, Headquarters
designsystem.digital.gov/ - 2026-10-28: links, Written in, GitHub stars, Contributors
api.github.com/repos/uswds/uswds - 2026-10-28: links
designsystem.digital.gov/documentation/getting-started-for-developers/ - 2026-10-28: First release
github.com/uswds/uswds/releases/tag/v0.8 - 2026-10-28: Maintainer
designsystem.digital.gov/about/website-policies-notices/ - 2026-10-28: Categories, Templating, License model
github.com/uswds/uswds/blob/develop/README.md - 2026-10-28: Install with
designsystem.digital.gov/documentation/developers/ - 2026-10-28: License
github.com/uswds/uswds/blob/v3.14.0/LICENSE.md - 2026-10-28: Current major version, Last release
github.com/uswds/uswds/releases/tag/v3.14.0 - 2026-10-28: npm downloads a week
api.npmjs.org/downloads/range/2026-09-28:2026-10-04/@uswds/uswds - 2026-10-28: Dependent packages, Dependent repositories
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40uswds%2Fuswds - 2026-10-28: Sites using it (HTTP Archive)
cdn.httparchive.org/v1/technologies