How to use USWDS
Implementations
Users of the U.S. Web Design System have created implementations for popular content management systems, web frameworks, and package managers that may help get you started more quickly and easily. Though some implementations may not include all of USWDS, they should give your team a strong foundation to work from.
If you have a new implementation to add to this list, please open an issue on GitHub or send us an email with the following information:
- The implementation’s target language and/or framework
- The author’s name (or alias) and contact URL or email address
- The most recent version of USWDS that the project targets
- Any useful caveats or other notes
Heads up
Some of the implementations listed here are not affiliated or endorsed, and have not been tested, by USWDS team. Use them at your own discretion.
| Name | Distribution | Status | Author or maintainer | Notes |
|---|---|---|---|---|
| ngx-uswds | Angular | GSA | This package provides Angular integration with USWDS.
|
|
| Sam-Prototypes | Angular | SAM.gov | A test application that incorporates sam-styles and sam-design-system components with real-world examples.
|
|
| Sam-Design-System | Angular | SAM.gov | Common Angular components integrated with sam-styles css framework.
|
|
| django-designstandards | Django |
stale
|
Paul Tagliamonte (USDS) | This package provides access to USWDS in Django applications.
|
| django-uswds-forms | Django |
archived
|
18F | This package provides Django Forms integration with USWDS.
|
| USWDS Drupal base theme | Drupal | Michael Feranda | A primary difference between this effort ( uswds_base) and the other USWDS theme (uswds) is that uswds-base uses a minimal approach. No extra JS/CSS is added in the primary theme and Classy is not used as a base.
|
|
| USWDS Drupal theme | Drupal | Brock Fanning | This base theme focuses on tweaking Drupal’s markup so that it will work with the USWDS library. Some CSS is added to deal with unavoidable Drupal quirks, but only as a last resort.
|
|
| USWDS CKEditor Integration | Drupal | Stephen Mustgrave | Add USWDS tables and accordions within CKEditor.
|
|
| USWDS Paragraph Components | Drupal | Stephen Mustgrave | USWDS components as paragraph bundles. Includes accordion, card, alert, process list, summary box, step indicator, and layout grid options.
|
|
| Sam-Styles | Fractal | SAM.gov | A Fractal build that generates an interactive component library for sam-styles.
|
|
| uswds-jekyll | Jekyll | 18F | A Jekyll theme for USWDS.
|
|
| uswds-simple-sass | npm and gulp |
archived
|
18F | This is a simple Node JS-based “starter project” that uses gulp and gulp-sass to
power a development workflow for a one-page site that leverages USWDS’
SASS. Note that this is a starter project and not a reusable package.
|
| 18f-contrib-web-design-standards | npm and node-sass |
stale
|
Brian DeRocher | A node-sass based wrapper of the U.S. Web Design System library.
|
| NuGet web-design-standards | NuGet |
stale
|
Abdul Ahad Monty | The NuGet Package has been created to access the library easily from Visual Studio NuGet Package Manager.
|
| USWDS components | Rails | Damien Burke (Talaria Software) | An implementation of USWDS for Rails applications using View Components. Demo
|
|
| uswds-rails | Rails gem |
archived
|
18F | This Ruby on Rails gem is not currently maintained.
|
| Comet | React | MetroStar | A React with TypeScript component library based on USWDS 3.0. This library provides modular support for custom components, data visualization, and command line tools. Comet also includes a sample starter app that is focused on accelerating and scaling design across the enterprise.
|
|
| react-uswds | React | Truss | A front-end component library aimed at implementing USWDS design patterns in React.
|
|
| uswds-sf-lightning-community | Salesforce Lightning |
archived
|
GSA IT (Mark Vogelgesang) | Allows users to toggle between native Salesforce components/functionality along with custom components built using USWDS. Meets GSA’s Guidelines for Digital Presence as well as tenets of 21st Century IDEA.
|
| USWDS WebJar | WebJars | VJ Kapur | For Java- and JVM-based build tools, such as Maven and Gradle.
|
|
| Broadcasting Board of Governors WordPress theme | WordPress | Broadcasting Board of Governors (BBG) | This is not a reusable WordPress theme, but an implementation of USWDS for bbg.gov).
|
|
| Benjamin | WordPress |
stale
|
Kyle Jennings | A WordPress theme built with Automattic’s _s, the U.S. Web Design System, and the needs of the people. For additional components and shortcodes, check out the Franklin plugin.
|
| The Standards | WordPress |
stale
|
Kyle Laverty | The Standards is a WordPress theme that is based on the U.S. Web Design System.
|
| NASAPress | WordPress | Brandon Ruffridge | A WordPress theme designed for NASA, built on the Sage starter theme, styled using the U.S. Web Design System. While it currently uses the NASA fork of the U.S. Web Design System, this could be swapped out by changing the dependency in package.json from nasawds to uswds.
|
|
| tailwindcss-uswds | Tailwind CSS plugin | Brian Hurst | A Tailwind CSS plugin for adding U.S. Web Design System design tokens to supported Tailwind utilities.
|
|
| Vue USWDS | Vue.js | Patrick Cate | A Vue.js implementation of the U.S. Web Design System.
|
|
| Americana Stack | Remix | NASA's General Coordinates Network (GCN) | A Remix Stack for US Federal web sites on AWS. Includes US Web Design System, react-uswds, and pre-commit hooks for linting and type checking.
|
Latest updates
Meaningful code and guidance updates are listed in the following table:
| Date | Description |
|---|---|
| 2023-07-11 |
Added entry for “Comet”. More information: uswds-site#2152 |
| 2023-03-09 |
Added entry for “sam.gov” implementations. More information: uswds-site#1714 |
| 2022-10-11 |
Added entry for “ngx-uswds”. More information: uswds-site#1715 |
| 2022-07-06 |
Added entry for “USWDS Components”. More information: uswds-site#1508 |
| 2021-10-04 |
Added entry for “USWDS Drupal base theme”. More information: uswds-site#1263 |
| 2021-07-27 |
Added entry for “USWDS CKEditor Integration” and “USWDS Paragraph Components”. More information: uswds-site#1233 |
| 2021-07-27 |
Added column for implementation status. More information: uswds-site#1233 |
| 2021-05-19 |
Removed entry for “us_web_design_standards gem”. More information: uswds-site#1227 |
| 2020-09-11 |
Added entry for “uswds-sf-lightning-community”. More information: uswds-site#1040 |
| 2020-08-12 |
Added entry for “tailwindcss-uswds”. More information: uswds-site#1024 |
| 2020-07-28 |
Added entry for “react-uswds”. More information: uswds-site#1003 |
