Style for including buttons, banners, and cards
Branch: master
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.


Style for including buttons, banners, and cards. Inspired by and somewhat based on USWDS.


All style components are viewable online.


As our code base expands, maintaining and remembering all the CSS class names has become difficult. The Style Guide makes the search and usage of CSS classes easier by providing examples of their usage. These styles are not meant for usage outside of Feel free to fork this though if you want to create your own style guide :-)


The repository is distributed with npm. After installing npm, you can install code-gov-style with this command:

$ npm i


This package is meant to be used with the code-gov-front-end project. Please follow the configuration settings for the project.

Link this package to edit styles locally

You may want to view your style changes in the code-gov-style repo on your local machine for testing. Follow these steps to do so:

  1. Clone the latest version of the code-gov-style repository.
  2. Run npm install to install the dependencies required for the package in the code-gov-style directory.
  3. Run npm link in the root level of the code-gov-style directory on your local machine.
  4. On the code-gov-front-end project, clone the repository and run npm install if you haven’t done this already.
  5. Run npm link in the root level of the code-gov-front-end directory on your local machine.

You are now using the latest version of the design system via your cloned version when running the code-gov-front-end site on your local machine. To stop using this version, run npm unlink from the root level of the code-gov-front-end directory.


We use the fa-search icon from Font Awesome. Font Awesome released their fa-search icon under this license

We copy-pasted some code from the hamburgers library to _hamburgers.scss. Hamburgers was created by Jonsuh. Hamburgers is released under the MIT License and can be found here as well as in the licenses folder in this repository.


Have a question? Check out our FAQS. If it's not there, feel free to post an issue or email us :-)


Contact Daniel J. Dufour at if you have any questions