A child design system built on top of the CMS Design System. Consists of SCSS overrides and React components for use on Medicare.gov websites.

Usage no npm install needed!

<script type="module">
  import cmsgovDsMedicareGov from 'https://cdn.skypack.dev/@cmsgov/ds-medicare-gov';


Medicare.gov Design System


>> View the full documentation site here <<

The Medicare.gov Design System contains shared design and front-end development resources for Medicare.gov applications, and is built on top of the CMS Design System (CMSDS). As a child design system, it inherits base styles, components, and guidance from the CMS Design System, while also adding its own features and customizations.


yarn add @cmsgov/ds-medicare-gov

For full documentation on installation and usage in your Medicare.gov product, please refer to our documentation site.


This site-wide design system has a much smaller group of users than the core CMS Design System. It's up to us to make it useful for our apps. It is a place to share code and collaborate across teams. It is our collective source of truth for design. If you want to contribute but need help getting started, shout in the #mgov-design-system Slack channel on the CMS Slack or open up an issue on this repo.


See the root CMSDS README.

Building on top of the CMS Design System

As a child design system, the Medicare.gov Design System shares the same tooling and organization as the CMSDS. For more information on how to extend and customize SASS, JS, and documentation, check out the child design system example and its documentation.

Design assets

You can find the Medicare design system Sketch file and related fonts in the design-assets folder.

You can also view the Medicare InVision Design System Manager design assets.

Additional links

  • For more information on the original Design System, check out its GitHub page.