Yale UI Component Library

The Yale UI Component Library was made to help developers build interfaces that match Yale’s visual identity, and follow WCAG 2 AA accessibility recommendations.

Table of Contents

Using the Compiled Assets

  1. Download the compiled assets OR install the compiled assets via npm with
npm install yale-ui-component-library

Within the folder, you’ll find the following directories with the compiled and minified CSS and JavaScript:

   +-- css/
       +-- yale-ui.css
       +-- yale-ui.min.css
   +-- js/
       +-- yale-ui-scripts.js
       +-- yale-ui-scripts.min.js
  1. Add the CSS and JS to your project’s asset folder.

  2. Include the CSS and JS as part of your project. (Note: You’ll have to also include jQuery and Popper.js separately.)

  <!-- ... -->
  <link rel="stylesheet" href="assets/css/yale-ui.css">
  <!-- ... -->
  <!-- ... -->
  <script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous";></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1" crossorigin="anonymous"></script>
  <script src="assets/js/yale-ui-scripts.js"></script>

Adding the Fonts

The UI Component Library uses the Mallory and YaleNew fonts, with Verdana being the fallback font for Mallory and Georgia being the fallback font for YaleNew. Information on Mallory and YaleNew fonts


A limited license for Mallory OpenType fonts may be requested by designated Yale graphic designers and vendors for Yale projects. Mallory Web fonts may be used for official Yale Web sites.

To add the Mallory font to your project, add the font to your fonts folder and add a CSS file with the following @font-face rules:

@font-face {
    font-family: "Mallory";
    src: url("fonts/Mallory/Mallory/Mallory-Light.woff") format("woff"),
         url("fonts/Mallory/Mallory/Mallory-Light.woff2") format("woff2");
       font-weight: normal;
    font-style: normal;
@font-face {
    font-family: "Mallory-Medium";
    src: url("fonts/Mallory/Mallory/Mallory-Medium.woff") format("woff"),
         url("fonts/Mallory/Mallory/Mallory-Medium.woff2") format("woff2");
       font-weight: normal;
    font-style: normal;


YaleNew is the official serif font for Yale websites.

To add the YaleNew font to your project, add the font to your fonts folder and add a CSS file with the following @font-face rules:

@font-face {
    font-family: "yalenew";
    src: url("fonts/YaleNew/YaleNew-normal-normal/yalenew-roman-webfont.eot");
    src: url("fonts/YaleNew/YaleNew-normal-normal/yalenew-roman-webfont.eot?#iefix") format("embedded-opentype"),
         url("fonts/YaleNew/YaleNew-normal-normal/yalenew-roman-webfont.woff2") format("woff2"),
         url("fonts/YaleNew/YaleNew-normal-normal/yalenew-roman-webfont.woff") format("woff"),
         url("fonts/YaleNew/YaleNew-normal-normal/yalenew-roman-webfont.ttf") format("truetype");
    font-weight: normal;
    font-style: normal;
@font-face {
	font-family: "yalemarks";
	src: url("fonts/YaleNew/YaleNew-marks/yalemarks-webfont.eot");
	src: url("fonts/YaleNew/YaleNew-marks/yalemarks-webfont.eot?#iefix") format("embedded-opentype"),
		 url("fonts/YaleNew/YaleNew-marks/yalemarks-webfont.ttf") format("truetype"),
		 url("fonts/YaleNew/YaleNew-marks/yalemarks-webfont.woff") format("woff"),
		 url("fonts/YaleNew/YaleNew-marks/yalemarks-webfont.svg#yalenewmarks") format("svg");
	font-weight: normal;
	font-style: normal;


The Yale UI Component Library documentation, included in the docs/ folder, is built with Jekyll and publicly hosted on GitLab Pages

Running the documentation locally

  • Requirements:
    • Git
    • Jekyll
    • NodeJS
    • Gulp
    • Yarn
  1. Clone the repo
    git clone https://gitlab.com/yale-a11y/ui-component-library.git
  2. Run bundle to install Jekyll for your project

  3. Run jekyll serve to build and serve the local web server at http://localhost:4000

Working With Source Files

We use Gulp to build all of our files and Yarn to handle our dependencies. If you wish to work with the source files, first run yarn in your command line to download the required node modules. To rebuild the project assets after working with the source files, run gulp in your command line.


We would love to have you contribute to this project! Email accessibility@yale.edu to discuss!

Version History and Change Log


  • Bundled entire Bootstrap JS (instead of individual Boostrap JS files)


  • Fixed npm package to include dist folder.
  • Added MIT license


  • Moved source code and documentation site to GitLab and GitLab pages, respectively.


  • Moved Scss files to dist folder to be included in downloadable zip file
  • Removed fonts and dist folders from commit history


  • Added Font Awesome v4.7 icon fonts back to flyout menu (included as CDN, with instructions)


  • Created npm package
  • Added Google Analytics to documentation site


  • Removed fonts from fonts folder (also removed @font-face rules in CSS)
  • Included instructions on how to add fonts
  • Added compiled and minified CSS and JS files to a downloadable zip file


  • Updated forms documentation with input types and HTML’s built-in validation features
  • Scrollable regions are now keyboard-accessible
  • Form input fields now have sufficient color contrast
  • Removed Mallory font (referencing a local GitHub page that hosts the Mallory font instead)
  • Removed local dependencies (yale-fonts and sass color contrast function) and added to src folder instead


  • Updated color variables so that everything is accessible by default (sass color contrast function warning will not appear)
  • Added Carousel component with documentation


  • Fix responsive menus and flyout menu example on examples page


  • Documentation Fixes
  • Adding yarn sassy script


  • Documentation for Nav and Navbar components
  • Implementation and documentation for the Yale Accessible Flyout Menu
  • Documentation for Progress Bars
  • Documentation for Pagination
  • Documentation for Media Object
  • Documentation for Jumbotrons
  • Documentation for Cards


  • Add popper.js dependency
  • Include nav and navbar from Bootstrap
  • Include badges from Bootstrap
  • Include cards from Bootstrap
  • Include dropdowns from Bootstrap, and add dropdowns to the compiled JavaScript
  • Inlucde jumbotron from Bootstrap
  • Include media from Bootstrap
  • Include progress from Bootstrap
  • Simplify custom typography implementation
  • Use navbar for documentation website
  • Tweak default focus styles
  • Tweak layout for documentation website


  • Change Bootstrap dependency to 4.3.1 from ^4.3.1
  • Add CSS autoprefixer to gulp tasks
  • Tweaked button typography
  • Add custom form elements


  • Combine tables, list groups, yale-bootstrap-base, buttons, and utilities into main repo, rather than separate projects
  • Update typography to be consistent with yale.edu
  • Add pagination component
  • Hard code CSS for flyout menus


  • Hotfix: remove broken reference to yale flyout menu


  • Tweaks to yale topper logo sizing
  • Include Bootstrap Transitions
  • More robust error message reporting for Sass color contrast functions


  • Updates to topper typography color
  • Skip Link added to documentation website


  • Updates to Alerts and Buttons documentation
  • Simplified the example gulpfile


  • Overhaul documentation to make it more consistent
  • Add documentation about extending, dependencies
  • Refactor project to separate the Bootstrap adjustment from the Yale branding skin
  • Update readme, documentation website homepage


  • Rewrite the gulpfile to concatenate all of our vendor libraries.


  • Add collapsible button for documentation example code snippets in example.html
  • Tables documentation
  • Alerts documentation
  • Forms documentation for validation messages
  • Bootstrap utilities documentation
  • Modal dialogs documentation
  • Simplify the implementation of _images.scss
  • Images documentation
  • List Groups documentation
  • Breadcrumbs documentation


  • Make the alerts link styles visually accessible by default (don’t require .alert-link class for accessible links inside of alerts)


  • Fixed a bug that caused documentation website pages and sidebar navigation to not be created effectively
  • Fixed a bug that caused documentation website pages to have the sidebar crash into the main column
  • Updated the readme file to point to the documentation website home page