# 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.


Source: https://findsoftware.frbit.cloud/uswds/
Last reviewed: 2026-10-28
Listed since: 2026-10-28

## Record

### Links

- home: https://designsystem.digital.gov
- repository: https://github.com/uswds/uswds
- docs: https://designsystem.digital.gov/documentation/getting-started-for-developers/
- x: https://twitter.com/uswds
- forum: https://github.com/uswds/uswds/discussions

### Identity

- status: active
- maintainer: U.S. General Services Administration
- maintainerType: unknown
- parent: unknown
- firstRelease: 2015
- hqCountry: US

### Kind

- category: ui-library, css-framework
- hosting: not applicable
- language: javascript
- runtime: unknown
- runtimeMin: not applicable
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: twig
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: npm

### License

- licenseModel: open-source
- license: CC0-1.0

### Releases

- currentMajor: 3
- latestReleaseDate: 2026-08-18

### Adoption

- githubStargazers: 7230
- packagistDownloads: not applicable
- npmWeeklyDownloads: 101252
- contributors: 197
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: 1054
- wordpressActiveInstalls: unknown
- dependentRepos: 131
- dependentPackages: 20

### Sources

- urls: https://designsystem.digital.gov/ (read 2026-10-28)
- urls: https://api.github.com/repos/uswds/uswds (read 2026-10-28)
- urls: https://designsystem.digital.gov/documentation/getting-started-for-developers/ (read 2026-10-28)
- firstRelease: https://github.com/uswds/uswds/releases/tag/v0.8 (read 2026-10-28)
- maintainer: https://designsystem.digital.gov/about/website-policies-notices/ (read 2026-10-28)
- hqCountry: https://designsystem.digital.gov/ (read 2026-10-28)
- language: https://api.github.com/repos/uswds/uswds (read 2026-10-28)
- category: https://github.com/uswds/uswds/blob/develop/README.md (read 2026-10-28)
- category: https://github.com/uswds/uswds/blob/develop/README.md (read 2026-10-28)
- installMethod: https://designsystem.digital.gov/documentation/developers/ (read 2026-10-28)
- installMethod: https://designsystem.digital.gov/documentation/developers/ (read 2026-10-28)
- templating: https://github.com/uswds/uswds/blob/develop/README.md (read 2026-10-28)
- license: https://github.com/uswds/uswds/blob/v3.14.0/LICENSE.md (read 2026-10-28)
- licenseModel: https://github.com/uswds/uswds/blob/develop/README.md (read 2026-10-28)
- currentMajor: https://github.com/uswds/uswds/releases/tag/v3.14.0 (read 2026-10-28)
- latestReleaseDate: https://github.com/uswds/uswds/releases/tag/v3.14.0 (read 2026-10-28)
- githubStargazers: https://api.github.com/repos/uswds/uswds (read 2026-10-28)
- contributors: https://api.github.com/repos/uswds/uswds (read 2026-10-28)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-09-28:2026-10-04/@uswds/uswds (read 2026-10-28)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40uswds%2Fuswds (read 2026-10-28)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/%40uswds%2Fuswds (read 2026-10-28)
- httpArchiveSites: https://cdn.httparchive.org/v1/technologies (read 2026-10-28)

## Notes

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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0