Integrating the Design System into your project

The Design System provides a set of modular HTML, CSS, and JavaScript patterns that can be used both collectively and individually. There are several ways to integrate it into your project:

  1. Installing individual components with npm or Yarn
  2. Downloading the compiled CSS

Installing individual components with Yarn or npm

Just want one or two Design System components and not the entire framework? Simply install and @import only the components you need.

Install with Yarn or npm

Pick one:

yarn add @cfpb/cfpb-buttons @cfpb/cfpb-icons


npm install @cfpb/cfpb-buttons @cfpb/cfpb-icons

Import Less

/* adjust paths to the modules as necessary */
@import "node_modules/@cfpb/cfpb-buttons/src/cfpb-buttons.less";
@import "node_modules/@cfpb/cfpb-icons/src/cfpb-icons.less";

Note: Be sure to run the Less files through Autoprefixer, or your compiled CSS might not work perfectly in older browsers.

Import JavaScript

import { Expandable } from '@cfpb/cfpb-expandables';

// initialize all expandables with class .o-expandable
// if they are within an element with id #container
Expandable.init( document.querySelector( '#container' ) );

Downloading the compiled CSS and JavaScript

While we recommend the above installation method to make future updates smaller and safer by allowing you to update one component at a time, there may be some use cases where it’s more appropriate to just grab a snapshot of the full Design System’s compiled CSS and JavaScript and drop it into a page. You can download the compiled Design System CSS and JavaScript from UNPKG.

Download the cfpb-design-system.css and cfpb-design-system.js files to your project and use standard <link> and <script> tags to include them. For example:

<!DOCTYPE html>
    <title>My Awesome Project</title>
    <link rel="stylesheet" href="css/cfpb-design-system.css">
    <link rel="stylesheet" href="css/your-project-styles.css">
    <!-- Your project's HTML goes here. -->
    <script src="js/cfpb-design-system.js"></script>
    <script src="js/your-project-scripts.js"></script>

Latest Updates

Page last edited: