The design system is a set of open source design and front-end development resources for creating Section 508 compliant, responsive, and consistent websites. It builds on the U.S. Web Design Standards and extends it to support additional CSS and React components, utility classes, and a grid framework to allow teams to quickly prototype and build accessible, responsive, production-ready websites.

You're currently at the root of a monorepo which contains multiple NPM packages in the packages/ directory.

The following packages are in this repo, view the README in each of these for additional details.

These packages are published to NPM and can be installed. View each package's README for installation instructions.

The core CSS and React components for the design system. Includes the Support package.

Sass variables, mixins, and functions. Included in the Core package.

A responsive flexbox grid framework.

These packages are only project dependencies, so they're not published to NPM for other projects to use.

This directory contains code related to the documentation website. Unless you're a contributor, this directory isn't that interesting to you.

A Yeoman generator used in the development process. Again, unless you're a contributor, this directory isn't that interesting to you.

Examples of the design system in use can be found in the examples directory.

Please read the CONTRIBUTING.md document to learn about setting up a local development environment, contributing to the design system, and our coding guidelines.