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

What’s new?

The latest news and updates on the Design System, Forms library and the Content style guide.

v1 components will be deprecated on May 3, 2024

All V1 components will be officially retired and no longer available for use by May 3, 2024. Teams that have chosen to opt out of migrating to v3 components will be automatically opted in on this date. Learn how to migrate a component.

Leap Year February 2024

The team continued to deliver web components synced to USWDS v3 and made updates and fixes to v3 components while the Figma Library continues to be built out.

New and updated components

  • va-breadcrumb: VA.gov home is now the default first label in #638
  • va-flle-input: Made accessibility visual updates to the focus state and error state in #2441

Bug fixes

  • va-modal: Fixed icon positioning in larger version in 2445
  • va-file-input: Made accessibility fix so it reads out selected files correctly in #2442
  • va-file-input: Disabled multiple file input dragging and dropping in #2479
  • va-icon: Updated to use sprite successfully in #2353
  • va-pagination: Fixed incorrect active page color in v3 in #2420
  • va-maintenance-banner: Remove banner role in #2429
  • Forms pattern: Updated headings to correct serif font in #2474
  • Forms pattern: Updated radio button to show title and required label in #2475

Deprecated React components

Modal (#1634, #2449, #2450)

Figma Library updates

  • Added Contact preferences pattern in #2452
  • Updated expandable alert with number of lines property in #2454
  • Added LinkedIn icon in #2497
  • Fixed font & link color for Email Template #2506

Documentation updates

  • Developer contribution page updates in #2446
  • va-alert and va-expandable-alert: Updated accessibility documentation for announcing alerts (role=”alert”) in #2145
  • Design Libraries has been updated with Figma information in #2410

Winter 2024

The team continued to deliver web components synced to USWDS v3 and brought the platform inline with the v3 color palette.

Global system changes to upgrade to USWDS v3

  • Update colors to USWDS v3 by @powellkerry in #1002
  • Update primary blues in CSS Library by @micahchiang in #974

New and updated components

  • Added USWDS v3 va-file-input by @Andrew565 in #1017
  • Added USWDS v3 va-featured-content (aka Summary box) by @ataker in #956
  • Added USWDS v3 va-search-input by @jamigibbs in #947
  • Added USWDS v3 va-modal by @harshil173 in #943
  • Added va-footer-minimal by @it-harrison in #937
  • va-checkbox-group: New form pattern support by @harshil1793 in #1034
  • va-text-input: Deprecating Max Length variation for V3 by @Andrew565 in #1025
  • va-radio: New form pattern support by @harshil1793 in #1009
  • va-card: add prop to display a gray background by @jamigibbs in #1029
  • va-banner: Set data-role to ‘region’ and create property data-label to set aria-label on first div child of nested va-alert by @eselkin in #1020
  • va-memorable-date: add new form pattern support by @ataker in #1013
  • va-textarea: add new form pattern support by @ataker in #1008
  • va-text-input & va-number-input: add new form pattern support to USWDS variations by @it-harrison in #985
  • va-breadcrumbs: add support for React Router via custom event by @it-harrison in #979

Bug fixes

  • va-text-input: require inclusion of charcount prop on component instances to enable character count by @it-harrison in #1049va-text-input: require inclusion of charcount prop on component instances to enable character count by @it-harrison in #1049
  • va-file-input: Disable multiple file inputs by @Andrew565 in #1046
  • va-alert: remove Background only variation for USWDS v3 by @powellkerry in #1035
  • va-alert: fix close button position on full-width by @it-harrison in #1033
  • va-memorable-date: make month default to input instead of select by @it-harrison in #1014
  • va-checkbox-group, va-radio: move hint to legend by @powellkerry in #1028
  • va-featured-content: Add ARIA label to featured content region by @rsmithadhoc in #1011
  • va-pagination: fix USWDS variation not showing next/previous page in list by @ataker in #977
  • va-alert: update uswds background and border colors by @harshil1793 in #1004
  • va-checkbox: Add error message styling by @Mottie in #1007
  • va-checkbox-group: make legend font match design spec by @it-harrison in #969
  • va-modal: fix for screen readers when using Storybook by @Andrew565 in #966
  • va-official-gov-banner: Fix for medium screens wrapping wrongly by @Andrew565 in #973
  • va-telephone: Add prop for passing a string to aria-describedby by @jamigibbs in #970
  • va-on-this-page: Fix left margin alignment by @nickjg231 in #957
  • va-footer-minimal: Add focus outline to logo by @jamigibbs in #954
  • Updated web-components to use variables from css-library by @it-harrison in #945
  • va-segmented-progress-bar: Hiding steps from JAWS by @Andrew565 in #960
  • va-omb-info, va-crisis-line-modal, va-minimal-header: Fix for focus trapping by @Andrew565 in #951

See the component-library release notes for more detailed issues on component fixes.

Deprecated React components

  • Breadcrumb
  • ExpandingGroup
  • IconBase
  • IconSearch
  • TextInput

Figma Library updates

Content style guide updates

Documentation updates

All documentation updates can be viewed in GitHub.

Summer 2023

The team continues to focus on building out new variations of our components based on USWDS v3.

New and updated components

USWDS v3-based components

  • Added va-accordion USWDS v3 variation by @powellkerry in #728
  • Added Additional info v3 by @harshil1793 in #703
  • Added va-breadcrumbs: Add USWDS variation by @harshil1793 in #711
  • va-icon: Add new web component @it-harrison in #772
  • Added va-process-list: Add USWDS variation by @ataker in #770

Bug fixes

A long list of bug fixes can be found in our component release notes.

Content style guide updates

Deprecated React components

  • Table
  • CheckboxGroup

Spring 2023

The team has mainly focused on building out new variations of our form components based on USWDS v3. However, we’ve also made the changes below.

New and updated components

See the component-library release notes for more detailed issues on component fixes.

Content style guide updates

New entries in Word list

  • Defense Department
  • Department of Defense
  • Edith Nourse Rogers STEM Scholarship
  • PACT Act
  • Service-connected disability rating

Deprecated React components

  • DropdownPanel
  • ProgressButton
  • RadioButtons
  • SystemDownView

Sketch Library updates

  • Added the aforementioned new Form components (Autosave, Need help?, Penalty notice, Prefill)
  • Templates library now uses the correct header and footer throughout.
  • Reorganized patterns to match new naming and nav structure.
  • Added sidenav mobile menu.

Documentation updates

Edit this page in GitHub (Permissions required)
Last updated: Feb 28, 2024