About
What's new?
The latest news and updates on the VA Design System.
Guidance Updates
October 27, 2025
What’s Changed
- Feedback Footer: Added component-specific feedback footer by @babsdenney in #4953
- Deprecated components: Move deprecated components to dedicated section by @babsdenney in #4968
- Component status update: Add maturity data for va-text and va-snackbar by @babsdenney in #5003
- Update breadcrumbs.md, keep-a-record-of-submitted-information.md, and confirmation.md by @derekwang99 in #4877
- Create whats-new.md: Adding new style guide page by @laurenvocke-va in #4768
- update to latest component-library release by @it-harrison in #5015
- Add optional meeting task for design kickoff by @caw310 in #5023
- Update memorable date hint text by @jeana-adhoc in #5028
- Enable manual deployment workflow trigger by @humancompanion-usds in #5037
- Add Accessibility Defect Report template by @jeana-adhoc in #5052
- New component documentation: Add Tag - Status variant by @babsdenney in #4981
- Add Accessibility bug template and update numbering by @jeana-adhoc in #5053
- Re-add launch blocking labels to match guidance by @jeana-adhoc in #5056
- Remove medical terminology paragraph by @jeana-adhoc in #5058
- Refine accessibility issue template details by @jeana-adhoc in #5061
- Refactor projects field in accessibility issue template by @jeana-adhoc in #5066
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-13…Sprint-14
October 13, 2025
What’s Changed
- Update component-library to latest v53.1.0 by @jamigibbs in #4902
- What’s New: Update release notes by @danbrady in #4905
- Files Pattern: add link to standalone file input example by @jamigibbs in #4900
- Tabs: Update screenshots by @babsdenney in #4895
- Update email template by @derekwang99 in #4860
- Rename .github/DSF-mobile-storybook.md to .github/ISSUE_TEMPLATE/DSF-… by @caw310 in #4956
- Add DSF mobile visual QA issue template by @caw310 in #4958
- Add issue template for mobile unit tests by @caw310 in #4957
- Add DSF mobile analytics issue template by @caw310 in #4955
- Update docs for font-size and line-height utilities, update monospace class names by @powellkerry in #4951
- Email and text notifications: Update guidance by @derekwang99 in #4842
- Update bulleted-lists.md: Adding new conjunction example by @laurenvocke-va in #4831
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-12…Sprint-13
September 29, 2025
What’s Changed
- Font: Adding monospace documentation by @babsdenney in #4577
- What’s New: Update release notes by @danbrady in #4852
- Mobile app documentation: Update component pages with mobile app checklist and tags by @babsdenney in #4647
- Add link to My VA docs by @jeana-adhoc in #4867
- Add automated content style guide review system by @humancompanion-usds in #4785
- va-file-input-multiple:add slotted content consideration guideline by @jamigibbs in #4861
- Add OMB Source to Form template by @jeana-adhoc in #4816
- Bump rexml from 3.4.1 to 3.4.2 in the bundler group across 1 directory by @dependabot[bot] in #4838
- Icons: Add guidelines for requesting new icons by @babsdenney in #4873
- Streamlining “Contributing to docs” and in-house style guide by @erinrwhite in #4887
- Fix a11y in metrics dashboard by @humancompanion-usds in #4813
- Updates content prompt to point at fresh VADS-specific guidance. by @humancompanion-usds in #4889
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-11…Sprint-12
VADS Component Library Releases
October 27, 2025
What’s Changed
Breaking Changes
- va-file-input: always show Delete & Change file options on error messages by @it-harrison in #1832
New Features & Components 🎉
- va-tag-status: Add new component by @RyanMunsch in #1806
- va-select: add label-header-level prop by @powellkerry in #1824
- web-components: standardize media queries across components by @powellkerry in #1826
Fixes
- va-file-input: bugfix for aria-labels not rendering on buttons by @powellkerry in #1819
- va-telephone: fix bug where extensions were not rendering for international phone numbers by @powellkerry in #1815
- va-file-input: prevent links from being focussed inside pdf preview by @powellkerry in #1817
- va-link-action: underline link on primary version by @powellkerry in #1820
- va-memorable-date: prevent race conditions with external validation by @it-harrison in #1831
- va-accordion-item: prevent selection of non-direct children as slot header by @powellkerry in #1835
- va-alert: add word-wrap on headline and body by @powellkerry in #1837
Other Changes
- css-library: add elevation tokens by @powellkerry in #1833
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v53.2.0…v54.0.0
October 13, 2025
What’s Changed
New Features & Components 🎉
- va-table: mono font by @powellkerry in #1805
Fixes
- va-memorable-date: Add translations for date hint and pass hint portions to child input components by @RyanMunsch in #1793
- font resize component fixes: phase 1 by @amyleadem in #1795
- va-file-input: update message when wrong file-type uploaded by @it-harrison in #1803
- va-combo-box: optgroup duplication and value bugs by @powellkerry in #1807
Other Changes
- css-library: add font-size and line-height tokens and utility classes for bitter and monospace fonts by @powellkerry in #1786
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v53.1.0…v53.2.0
September 29, 2025
What’s Changed
New Features & Components 🎉
- va-accordion: create separate buttons for “expand all” and “collapse all” by @amyleadem in #1772
- va-memorable-date: add labelHeaderLevel prop by @powellkerry in #1775
- va-text-input: add the vaInput custom event by @jamigibbs in #1798
- va-text-input: add password type variation by @RyanMunsch in #1787
- va-file-input: use new password variation to mask file password by @RyanMunsch in #1787
Fixes
- va-table: add interactive elements to a cell by @ediiotero in #1752
- va-button-segmented: update details payload for analytics event by @RyanMunsch in #1779
- va-file-input: replace
<hr/>element with a border on parent by @RyanMunsch in #1792
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v53.0.0…v53.1.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).
Links
- 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