About
What's new?
Guidance Updates
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
What’s Changed
- What’s New: Update release notes by @danbrady in #4770
- Add VADS Metrics Dashboard with Issue Tracking Charts by @humancompanion-usds in #4497
- Button: Updating urls in guidance by @babsdenney in #4766
- Update index.md with sections and guidance by @jonichan-ia in #4602
- 📊 Integrate ds-components CSV data into metrics dashboard by @humancompanion-usds in #4779
- Update ask users for files pattern guidance with code usage links by @jeana-adhoc in #4795
- Divider: Fix typo by @derekwang99 in #4790
- Add guidance for hiding hint text in va-memorable-date by @jamigibbs in #4786
- Adds documentation for monospace font class on utilities font-family page by @powellkerry in #4809
- IA updates: move contributing to docs page, add VADS style guide, update naming conventions by @erinrwhite in #4787
- Major re-write of forms template sections in VADS by @jeana-adhoc in #4811
- update component library to latest by @it-harrison in #4828
New Contributors
- @derekwang99 made their first contribution in #4790
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-10…Sprint-11
What’s Changed
- What’s New: Update release notes by @babsdenney in #4693
- Fixes a bunch of dead links in VADS by @jeana-adhoc in #4697
- Tabs: Updated guidance based on staging review findings by @babsdenney in #4698
- 3686 conditionally revealed error by @jeana-adhoc in #4703
- 404 link by @jeana-adhoc in #4702
- Add url guidance for multiple responses pattern by @jeana-adhoc in #4708
- Add widescreen to breakpoints table by @jamigibbs in #4684
- Clarifying form page headings by @jeana-adhoc in #4730
- Adds URL to bug template by @jeana-adhoc in #4739
- Adding accessibility guidance for va-link by @jeana-adhoc in #4742
- update component-library to 52.1.1 by @it-harrison in #4760
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-9…Sprint-10
VADS Component Library Releases
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
What’s Changed
Breaking Changes
- va-date, va-memorable-date, va-telephone-input, va-text-input: Update onblur validation by @powellkerry in #1760
New Features & Components 🎉
- va-on-this-page: Convert title list item to a header element by @amyleadem in #1759
- va-memorable-date: Add prop to remove the default date hint by @jamigibbs in #1763
Fixes
- va-button-segmented: Update styles for two/three buttons by @RyanMunsch in #1762
- va-textarea: Fix horizontal overflow at high zoom by @amyleadem in #1768
- va-memorable-date: Add watch decorator to the value prop by @jamigibbs in #1770
- va-modal: Fix focus trap bug (and clean up component file) by @RyanMunsch in #1773
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v52.1.1…v53.0.0
What’s Changed
Fixes
- va-omb-info: remove “View” from privacy act statement button by @amyleadem in #1740
- va-telephone-input: improve error message accuracy by @powellkerry in #1726
- va-accordion-item: update headline slot approach to resolve unescaped HTML entities by @RyanMunsch in #1741
- va-telephone-input: correct width/media query breakpoint by @RyanMunsch in #1744
- va-additional-info, va-alert-expandable, va-memorable-date: adjust slot styles by @powellkerry in #1746
- va-radio and va-telephone-input: improve consistency of the error message screen reader announcement by @amyleadem in #1724
- va-date: add spacing when fields wrap by @powellkerry in #1747
- va-file-input: only show password field and additional info slot if progress bar not visible by @powellkerry in #1749
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v52.1.0…v52.1.1
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)