Packages the U.S. Web Design Standards assets as a Ruby Gem for use in a Jekyll project
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

This gem has been deprecated.

us_web_design_standards: U.S. Web Design Standards style assets gem

Provides the style assets from the U.S. Web Design Standards as a Ruby Gem.

Provides plugins for use with Jekyll-based web sites. Other frameworks may be supported in the future.


This gem is compatible with Jekyll. If you are looking for a Ruby on Rails version, please see the USWDS Rails gem.


In your Gemfile, include the following:

group :jekyll_plugins do
  gem 'us_web_design_standards'

Add a uswds.scss file to your project in the asset directory of your choosing that contains at least the following:


@import "us_web_design_standards";

Integrate the generated uswds.css file and its styles into your project's layouts and templates, build the site per usual, and observe the results.


First, choose a Jekyll site you'd like to use to view the impact of your updates and clone its repository; then clone this repository into the same parent directory. For example, to use the 18F Guides Template:

$ git clone
$ git clone

In the Gemfile of the Jekyll site's repository, include the following:

group :jekyll_plugins do
  gem 'us_web_design_standards', :path => '../us_web_design_standards_gem'

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.