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.

August updates! We reorganized our patterns in August.

About

Getting started with design.va.gov

This site provides design guidelines and code to help you quickly create trustworthy, accessible, and consistent digital services on the VA.gov platform. Its primary audience includes content writers, designers, and front-end developers who work on VA.gov.

Guides by audience

Quick, easy, secure, and accessible

Design principles

VA.gov design principles are fundamental pieces of guidance that help teams building on the platform make their applications consistent with the Office of the Chief Technology Officer’s (OCTO) standards of quality in the user experience.

21st Century Integrated Digital Experience Act (IDEA)

The VA Design System complies with the 21st Century IDEA, signed into law in December 2018, as it is built on top of a fork of the U.S. Web Design System (USWDS v1.6.10). In other words, there is no need to include the USWDS into your project because the VA Design System already includes the USWDS.

We have added components, patterns, and other features unique to the needs of the VA.gov platform, all tested with Veterans to meet our usability and accessibility guidelines.

Browser support

The Design System supports older and newer browsers through progressive enhancement. We follow the 2% rule: we support any browser above 2% usage as observed by analytics.usa.gov.

Latest versions of Firefox
Latest versions of Google Chrome
Latest versions of Microsoft Edge
Latest versions of Safari
IE 11 and up (to be deprecated in 2022)
Edit this page in GitHub (Permissions required)
Last updated: Jun 27, 2022