About
Community
We have an active open source community of content specialists, designers, engineers, and other technologists. Contributors support dozens of agencies and hundreds of websites across the federal government.
Join the community
The USWDS community has been working together since 2015 to make it easier to build accessible, mobile-friendly government websites.
Join us in USWDS GitHub Discussions. The community is open to the public. Members include content specialists, designers, engineers, and other technologists who share ideas, challenges, lessons learned, and best practices in design and design systems.
Find the right conversation
- Questions and implementation help: Ask in Q&A, or Accessibility discussions for accessibility guidance.
- Early ideas: Explore suggestions and tradeoffs in Ideas.
- New components and patterns: Start a Proposal.
- Bugs and concrete enhancements: Use USWDS Issues to describe the problem and the behavior you expect. Accessibility defects belong here too.
- Documentation website problems: Report incorrect documentation or website behavior in uswds-site Issues.
Search existing conversations before starting a new one. If you are unsure whether you need implementation help or found a bug, start in Q&A. A maintainer can help route the conversation and create a linked issue when there is work to track.
Contribute to USWDS
There are several ways to contribute to USWDS. Participating in the community is one way to contribute. See our contributing guidelines for more about how to contribute back to our codebase. Also, please note that every submission we receive goes through a full design and code review.
Community conduct
By contributing to this repository, you agree to adhere to the GSA Social Media Policy (Section 10 Engagement). We expect all contributors, both internal and external, to engage respectfully and professionally in all project-related public communications.
Community participants also follow the Digital.gov Community Guidelines. Respect your peers, use plain language, be patient, practice constructive criticism, and stay organized.
Latest updates
Meaningful code and guidance updates are listed in the following table:
| Date | Description |
|---|---|
| 2026-09-17 |
Replaced retired TTS Code of Conduct references with the current GSA Social Media Policy statement. More information: uswds-site#3309 |
| 2026-09-17 |
Added guidance for choosing between Issues and Discussions. Linked questions, accessibility guidance, ideas, proposals, and actionable work to their destinations. More information: uswds-site#3308 |
| 2026-09-16 |
Removed outdated community manager information. More information: uswds-site#3301 |
| 2026-09-16 |
Updated community links to point directly to USWDS GitHub Discussions. Removed Slack signup instructions. More information: uswds-site#3301 |
| 2025-05-02 |
Replacing all references to chat.18f.gov. 18f.gov was decommissioned, preventing people from accessing this form. Now linking directly instead. More information: uswds-site#1849 |
| 2025-04-30 |
Removed Dan Williams from the community managers section and added Anne Petersen. More information: uswds-site#1849 |
| 2022-10-20 |
Updated community conduct section. More information: uswds-site#1849 |
| 2022-08-29 |
Removed Ammie Farraj Feijoo from the community managers section. More information: uswds-site#1750 |
