Latest commit 0b42cee Aug 17, 2018
Failed to load latest commit information.
.github Add (#80) Jul 5, 2017
design-assets Sketch: Update type styles Mar 15, 2018
examples Update React in example Dec 7, 2017
packages Release v1.24.0 Aug 17, 2018
scripts Add check to confirm NPM user is correct Dec 26, 2017
tools Add support for documentation pages with only a React example Mar 14, 2018
.babelrc Consolidated `optional` and `required` props into a `requirementLabel… Oct 11, 2017
.eslintignore Internal: Add prettier and precommit hook (#162) Oct 24, 2017
.eslintrc Create @cmsgov/eslint-config-design-system (#157) Oct 2, 2017
.gitattributes Replace lingering Jenkinsfile Oct 1, 2017
.gitignore Feature/autocomplete field (#201) Dec 20, 2017
.prettierignore Internal: Fix Yeoman generator issue caused by Prettier (#194) Nov 27, 2017
.prettierrc Change to camel-cased singleQuote to work with VSCode Dec 5, 2017
.travis.yml Replace references to staging branch with master (#190) Nov 8, 2017 Open source all the things (#52) May 17, 2017 Internal: Add option to build docs/ into theme folder (#221) Jan 11, 2018 Add (#80) Jul 5, 2017
Gulpfile.js Add Jenkins integrations (#16) Mar 20, 2017 Add checkedChildren and uncheckedChildren props to Choice (#173) Nov 4, 2017 Add PoC email (#272) Jul 26, 2018
browserslist Move autoprefixer config to suggested browserslist config Feb 6, 2017
lerna.json Release v1.24.0 Aug 17, 2018
package.json Bumping Webpack to fix dev server IE11 error. (#273) Aug 2, 2018
stylelint.config.js Internal: Run prettier on Sass files (#181) Oct 30, 2017
yarn.lock Bumping Webpack to fix dev server IE11 error. (#273) Aug 2, 2018

CMS Design System Build Status

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 located in the packages directory of this repo. View the in each of these for additional details.

Name Description
Core The core CSS and React components for the design system. Includes the Support package.
Layout A responsive flexbox grid framework.
Support Sass variables, mixins, and functions. Included in the Core package.

Internal packages

These packages are project dependencies, mostly focused around the design system's developer tooling and documentation.

Name Description
Documentation site This directory contains code related to the documentation website. Unless you're a contributor, this directory isn't that interesting to you.
ESLint config The ESLint rules we use to lint the design system's JS and React components
Stylelint config The Stylelint rules we use to lint the design system's Sass
Yeoman generator 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 document to learn about setting up a local development environment, contributing to the design system, and our coding guidelines.


To contact the CMS Design System product owners, please email