Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

About

Contributing to the design system

Overview

Veteran-facing teams are expected to use design system patterns and components when possible. If existing components or patterns will not work to address needed designs, VFS teams can suggest new components or patterns by going through our Experimental Design process outlined below.

All new components or patterns should go through this process. We recommend starting this process before sharing new designs widely with stakeholders.

This process works best if started before development begins, during the design phase.

When considering if a component or pattern should be added to the design system there are a few criteria that define a “good” candidate:

  1. The component or pattern is already being used on more than one page on VA.gov, or the designer can give examples of multiple places the component could be used.
  2. The component or pattern is different in more than one major way than existing components in the design system, if the component is only different in color or format, for instance, then it would be better as a variant of the existing component. Note that variants of existing components should also go through this experimental process.
  3. Our existing components and patterns will not solve the user problems sufficiently.
Edit this page in GitHub (Permissions required)
Last updated: Jun 28, 2022