Skip to main content

We released USWDS v2 in April 2019. For current information on USWDS, visit

This USWDS v1 site is archived. It is read-only, so use it for v1 only.

U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you're on a federal government site.


The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

The U.S. Web Design System (USWDS) is a library of design and code guidelines to help agencies create trustworthy, accessible, and consistent digital services. The Design System is being used on over one hundred government sites, with an audience of 120 million users. In this 12th post in our series, we sat down with Jason Garber, front-end web developer at the U.S. Digital Service (USDS)’s Defense Digital Service, to talk about his work creating a Ruby gem for the new that integrates the Design System into a Ruby on Rails application.

USWDS team: How did you hear about the U.S. Web Design System?

Jason Garber: The military has a really complicated system for moving service members’ property and we are working to improve this experience. I’m working on a Ruby on Rails app that will support part of the project,, and found out about the Design System from a designer on the team who started using them to speed up the design process.

As we were looking to see how we could most easily integrate the Design System, I found an existing, unmaintained Ruby gem that hadn’t gotten a lot of love. I thought I could quickly spin up an updated version that works with our app, and pulls in the latest version of the Design System. It wasn’t terribly difficult, but there was some manual labor involved. Overall, I’m pretty happy with how it’s turned out and whenever the Design System team publishes a new version, I’ll update the gem to keep it fresh.

USWDS team: Were there any challenges in working with the Design System?

Garber: There were some challenges specific to exposing assets in a gem to a Rails app. Rails’ Asset Pipeline provides a Rails-specific group of helpers for generating asset paths in development and production environments. Anywhere the Design System reference an asset, I manually updated the Sass (SCSS) files to use these helpers. Now that I’ve got it down, updating the gem isn’t terribly difficult. For me, coming into the U.S. Digital Service and having the Design System there certainly made our lives easier.

USWDS team: How did it make your lives easier?

Garber: As a front-end developer, I don’t have to spend a bunch of time making a grid system, or thinking about what markup to use, I can reference the Design System, which has great documentation. It saved us a ton of time spinning up a prototype that we could show to service members when we’re doing user testing. We can ask them how this new site compares to what they’re currently using. We couldn’t have gotten a prototype in front of our users as quickly without the Design System.

USWDS team: Were there any unintended consequences or surprises in using the Design System?

Garber: Inevitably, you run into something you need to build that doesn’t exist in the Design System and you have to build it by hand.

USWDS team: Is there anything the Design System team could do to help you in your efforts?

Garber: Nothing springs to mind: the documentation is great, Fractal is coming along, and being in the #uswds-public Slack channel is fantastic. I don’t participate a ton in there, but it’s nice to see the conversation. If I do have a quick question, it’s a great alternative to filing a GitHub issue and I appreciate it.

I’m pretty happy with the level of engagement from the Design System team. They have been pretty responsive answering questions. The conversation so far has been very welcoming and helpful. It’s great seeing so many people who are actually involved in building the Design System, also responding to questions.

USWDS team: Advice for other agencies?

Garber: I think it’s great that the Design System exists. On the one hand, government is so large that it would be difficult to prescribe that every site should use the Design System—to meet every need would be impossible. But, to have the Design System as a starting point, or “guard rails,” is great. Going to any government website and seeing at least some consistency across the board is a great way to build trust.

We’re looking to learn more from agencies that have used the Design System. If you’re interested in talking to us about your experience or have any feedback, feel free to send us an email at You can also chat with the team in the public Slack channel for the Design System.