# uswds/uswds

The U.S. Web Design System helps the federal government build fast, accessible, mobile-friendly websites.

Repository: https://github.com/uswds/uswds
Canonical: https://ross.abutalabs.com/products/uswds
Homepage: https://designsystem.digital.gov
Language: SCSS
License: NOASSERTION
License Family: other
Topics: design-systems, design, government, uswds
Last push: 2026-08-26T18:48:22+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 4123, "days_push": 7, "days_rel": 15, "gap_med": 76, "n_releases_24m": 6}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7161, forks 1099 (observed 2026-08-28T04:09:56.324503+00:00)

## What it is
The United States Web Design System (USWDS) is a library of open source UI components, design tokens, utilities, and a visual style guide for building accessible, mobile-friendly government websites. It ships as an npm package of Sass/CSS and JavaScript, customizable via theme settings, with companion design kits for Figma and Sketch.

## Use cases
- build an accessible federal government website
- get Section 508 compliant UI components
- create a mobile-friendly public sector website
- apply a consistent design token system to a web project
- prototype government service pages quickly with utilities
- customize a themed component library via Sass settings

## When to choose
- you're building a U.S. federal or state government website and need standards compliance
- accessibility (WCAG/Section 508) is a hard requirement
- you want pre-built, tested components with a coherent visual style
- you need a public-domain design system usable in any project

## When to avoid
- you need a highly custom or branded non-government visual identity
- your stack doesn't use Sass or you can't run a Sass compilation step
- you want a full JavaScript application framework rather than CSS/HTML components
- you need React/Vue component bindings (USWDS ships framework-agnostic HTML/CSS/JS)

## Facets
- artifact type: library
- maturity: active
- function: ui-components, css-framework, frontend-framework, theme, accessibility
- domain: web-development, frontend, web-design, accessibility, e-government
- platform: cross-platform
- tags: design-system, design-tokens, sass, scss, government-websites, section-508, uswds, figma-design-kit, web-server, nodejs

## Member repositories
- uswds/uswds (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:56.324503+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:39:58.423806+00:00, confidence not recorded.
  - readme: https://github.com/uswds/uswds (fetched 2026-08-28T04:09:56.324503+00:00, sha b79fa26a65e5)
  - homepage: https://designsystem.digital.gov (fetched 2026-08-29T08:35:34.185922+00:00, sha 567e476d9762)
  - site_page: https://designsystem.digital.gov/documentation/getting-started-for-developers (fetched 2026-08-29T08:35:34.188540+00:00, sha a790ea99bb4a)
  - site_page: https://designsystem.digital.gov/documentation/getting-started-for-designers (fetched 2026-08-29T08:35:34.190518+00:00, sha b0b614d027e3)
  - site_page: https://designsystem.digital.gov/documentation/developers (fetched 2026-08-29T08:35:34.192283+00:00, sha 64e653d31a9e)
  - site_page: https://designsystem.digital.gov/documentation/settings (fetched 2026-08-29T08:35:34.194973+00:00, sha c2fd2cd3e35b)
  - site_page: https://designsystem.digital.gov/documentation/accessibility (fetched 2026-08-29T08:35:34.198036+00:00, sha 96a5b68eaf92)
  - site_page: https://designsystem.digital.gov/documentation/code-guidelines (fetched 2026-08-29T08:35:34.200074+00:00, sha 6351692503cf)
  - site_page: https://designsystem.digital.gov/documentation/migration (fetched 2026-08-29T08:35:34.202277+00:00, sha abe2821b8f58)
  - site_page: https://designsystem.digital.gov/documentation/migration-v2 (fetched 2026-08-29T08:35:34.205122+00:00, sha 87c880371571)
- Data as of 2026-08-30T08:39:29.467469+00:00.