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.

Latest release: Component Library: v54.5.2 released on Jan 20, 2026 | Guidance: Sprint 20 released on Jan 20, 2026 | Figma: Changelog

About

What's new?

The latest news and updates on the VA Design System.

Guidance Updates

Sprint 20
January 20, 2026

What’s Changed

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-18…Sprint-20

 Sprint 19
January 5, 2026

What’s Changed

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-18…Sprint-19

 Sprint 18
December 22, 2025

What’s Changed

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-17…Sprint-18

VADS Component Library Releases

v54.5.2
January 20, 2026

What’s Changed

Fixes

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.5.1…v54.5.2

 v54.5.1
January 20, 2026

What’s Changed

Fixes

  • Dependencies: Downgrade react-output-target to 0.5.3 by @amyleadem in #1947

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.5.0…v54.5.1

 v54.5.0
January 20, 2026

What’s Changed

New Features & Components 🎉

Fixes

  • va-file-input: Update focus management for errors and interactive child elements by @RyanMunsch in #1886
  • va-modal: exclude va-icon from focus trap query selectors by @jamigibbs in #1943

⚠️ Potential impact to downstream applications and tests

This release includes updates to rendered component markup that may affect existing applications or test suites. Review the notes below for guidance on resolving test failures for affected components.

  • va-file-input: We removed the role="alert" attribute from error message <span> elements and updated the text content of the input’s aria-label. If your code or tests rely on these attributes, update your selectors or assertions to match the updated component structure.

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.4.2…v54.5.0

Figma Component Library Changelog

Content Style Guide Updates

August 2025

Dates, times, phone numbers, and addresses

Added an exception to time zone formatting for automated time stamps:

For automated time stamps from the time library used in vets-website (date-fns), the time zone uses the 3-letter format (ex. EDT).

  • Revised guidance on inline/embedded links:

    In general, put a link on a separate line to help it stand out. Have a case where you think an inline link might be necessary due to space limitations? Contact the centralized content team for help with your content.

  • Fixed broken link to the Links component page.

Numbers, signs, and symbols

  • Changed the page title to Numbers, signs, and symbols
  • Added the ampersand information (moved from the Punctuation page; no changes to the guidance)
  • Clarified that there are no spaces around degree symbols or percent signs
  • Revised the guidance on using “1” versus “one” to only use “one” with certain expressions:

    Spell out “one” when it’s used in expressions like one-to-one, one-on-one, one-time, and “one of the reasons…” Use the numeral “1” for all other instances.

  • Made edits to the rest of the page to align with our style (these edits don’t affect guidance)

Punctuation

  • Removed the information on ampersands (moved this to the Numbers, signs, and symbols page)
  • Added an exception for using quotes when referring to buttons, section titles, etc. if the text is already bold:

    Note: If the text is already bold (like in some error messages), we can use quotation marks to reference buttons, screens, or section headers.

  • Made edits to the rest of the page to align with our style (these edits don’t affect guidance)
Edit this page in GitHub (Permissions required)
Last updated: Oct 15, 2025