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

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

Use of this Design System beyond VA.gov

The 21st Century Integrated Digital Experience Act (IDEA), signed into law in December 2018, requires teams at VA to consider using the U.S. Web Design System, and to coordinate and ensure alignment of internal and external programs. Thus we strongly encourage you to use the VA design system and/or the US Web Design System as you’re building products, whether for an internal or external audience. However, there is currently no requirement to follow the guidance in this design system for internal tools.

From 21st Century IDEA:

(c) Internal Digital Services.–The head of each executive agency shall ensure, to the greatest extent practicable, that any Intranet established after the date of enactment of this Act conforms to the requirements described in subsection (a).

While Subsection A does not mandate use of the U.S. Design System for internal tools, it does indicate that it is part of the strategy an agency should employ:

coordinate and ensure alignment of the internal and external customer experience programs and strategy of the executive agency; and Compliance With United States Website Standards.–Any website of an executive agency that is made available to the public after the date of enactment of this Act shall be in compliance with the website standards of the Technology Transformation Services of the General Services Administration.

Edit this page in GitHub (Permissions required)
Last updated: Mar 08, 2023