How to use USWDS


Now that you’ve gotten started, the following resources are available to help you stay in touch, to provide support as you continue with your projects, and to enable you to provide recommendations and feedback.

Need installation help?

Do you have questions or need help with setup? Did you run into any weird errors while following these instructions? Feel free to open an issue in GitHub.

You can also email us directly at

Stay involved

USWDS is supported by an active, open-source community of engineers, content specialists, and designers.

Continue learning

We regularly update USWDS. To stay informed of changes, tips, and tricks, join us for our monthly calls and/or subscribe to Wave, our newsletter.

Contribute to the codebase

For complete instructions on how to contribute code, please read These instructions also include guidance on how to set up your own copy of the design system style guide website for development.

If you would like to learn more about how we work, check out the Workflow and Issue label Glossary pages on our wiki.

If you have questions or concerns about our contributing workflow, feel free to open an issue, such as the following in GitHub:

  • Bug report — Report a bug and help USWDS improve.
  • Feature request — Suggest a new idea for the design system.
  • Report a security vulnerability — Report potential security issues. Review our security policy for more details.

You can also email us directly at

Latest updates

Meaningful code and guidance updates are listed in the following table:

Date Description

Added resources page. More information: uswds-site#1422