About
What's new?
Guidance Updates
What’s Changed
- Fix CSS class selector mismatch for mermaid chart captions by @Copilot in #5161
- Fix CSS class name mismatch in mermaid chart styles by @Copilot in #5164
- Mermaid chart: Use semantic figure and figcaption elements by @Copilot in #5167
- Fix screen reader skip link anchor to include full decision tree content by @Copilot in #5168
- Implement conditional loading of Mermaid.js library by @Copilot in #5169
- Add accessibility improvements to mermaid-chart.html include by @Copilot in #5170
- Links vs Buttons: Add examples to text-based decision list by @Copilot in #5286
- [WIP] Address feedback on documentation updates for mermaid charts by @Copilot in #5287
- Indeterminate state clarifying changes by @jeana-adhoc in #5294
- chore: update releases for Sprint 17 by @humancompanion-usds in #5298
- Documentation updates: Replace flow chart images with mermaid charts by @babsdenney in #5062
- Add indeterminate accessibility note by @danbrady in #5279
- Add screencast for TMF (21-4140 scaffold and chapters) by @humancompanion-usds in #5313
- Enlarge POW summary image by @danbrady in #5315
- 📊 Update metrics dashboard data - 2025-12-12 by @humancompanion-usds in #5319
- Enhance guidance for displaying submission statuses by @eileen-coforma in #5307
- Update unordered-list.md: Style guide edits to list items by @laurenvocke-va in #5332
- Update and rename use-pronouns.md to use-conversational-language.md: … by @laurenvocke-va in #5299
- Documentation for new pattern Helping users… to navigate multiple forms by @jeana-adhoc in #5227
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-17…Sprint-18
What’s Changed
- va-icon: Add expand_circle_right icon by @babsdenney in #5200
- chore: update releases for Sprint 16 by @humancompanion-usds in #5251
- update component library to latest by @it-harrison in #5259
- Remove duplicate link by @danbrady in #5261
- Update Email Address pattern references from VA.gov Profile to VA Profile API by @eileen-coforma in #5241
- Update guidelines for asking race and ethnicity data by @eileen-coforma in #5242
- Update Keep a record of submitted information pattern with reference to My VA cards with download links by @eileen-coforma in #5260
- Signed out vs. signed in template: Update mobile menu screenshots by @eileen-coforma in #5262
- Update direct deposit pattern to include review design by @eileen-coforma in #5270
- adds staging review count by quarter by @humancompanion-usds in #5252
- Create links-in-lists.md: Adding new links in lists content by @laurenvocke-va in #5244
- Update payments-and-debts.md: Updated terms by @laurenvocke-va in #5240
- Update punctuation.md: Adding formatting section by @laurenvocke-va in #5248
- Update “user” guidance on VADS by @danbrady in #5223
- Update index.md: Adding title length guidance by @laurenvocke-va in #5253
- Update index.md: Added heading length guidance by @laurenvocke-va in #5255
- Update recover-from-errors.md: Added heading length guidance by @laurenvocke-va in #5256
- 📊 Update metrics dashboard data - 2025-11-21 by @humancompanion-usds in #5233
- Focus management: Update focus guidance by @amyleadem in #5225
- Metrics: Adds looker report on metrics for Nov. by @humancompanion-usds in #5288
- Update to component-library v54.3.0 by @RyanMunsch in #5297
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-16…Sprint-17
What’s Changed
- chore: update releases for Sprint 15 by @humancompanion-usds in #5163
- BUG: Remove references to Promo banner component in side nav by @babsdenney in #5174
- Update Service History documentation by @eileen-coforma in #4872
- Creates a script to analyze bug issue count for components. by @humancompanion-usds in #5201
- Bump js-yaml from 3.14.1 to 3.14.2 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #5204
- Metrics: Adds reports for Sept and Oct. by @humancompanion-usds in #5210
- update ssn screenshot by @jeana-adhoc in #5217
- Metrics: Fix bash heredoc syntax error in Create Pull Request step by @humancompanion-usds in #5211
- 📊 Update metrics dashboard data - 2025-11-18 by @humancompanion-usds in #5212
- Critical Action: Updates placement guidance per content audit by @Copilot in #5203
- Update links in service-history.md to include ‘skip’ by @eileen-coforma in #5213
- Added field asking for verification of an issue in a second SR or Browser by @jeana-adhoc in #5229
New Contributors
- @eileen-coforma made their first contribution in #4872
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-15…Sprint-16
VADS Component Library Releases
What’s Changed
Fixes
- Build failure fix: Downgrade web-components react version to 17 by @amyleadem in #1931
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.4.0…v54.4.1
What’s Changed
New Features & Components 🎉
- NPM package updates for security vulnerabilities by @dependabot[bot] in #1697
- va-omb-info: Add logic to convert respondent burdern to hours & minutes by @RyanMunsch in #1909
Fixes
- va-progress-bar: use sass file by @it-harrison in #1912
- Pin all dependencies by @ediiotero in #1911
- va-memorable-date: update Storybook examples & remove padding on legend by @jamigibbs in #1920
- va-segmented-progress-bar: Use single span for accessible text. by @RyanMunsch in #1917
- va-pagination: update aria-labels to include total pages in each label by @RyanMunsch in #1916
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.3.0…v54.4.0
What’s Changed
New Features & Components 🎉
- va-maintenance-banner: add header level prop by @jamigibbs in #1898
Fixes
- va-omb-info: add clickToClose to modal by @powellkerry in #1905
- va-crisis-line-modal: add option to only render modal, open modal via custom document event by @powellkerry in #1895
- va-alert: add screen reader text to announce alert status by @jamigibbs in #1847
- va-tag-status: Update sr-only text and
screenReaderTextprop by @RyanMunsch in #1896
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.2.0…v54.3.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)