About
What's new?
What’s Changed
- chore: update releases for Sprint 29 by @Amy-Leadem in #6379
- Add ADR 008 for file upload + metadata flow and refresh design-decision index date by @Copilot in #6381
- Bump @department-of-veterans-affairs/component-library from 56.5.0 to 56.6.0 in the va-design-system-libraries group by @dependabot[bot] in #6382
- Update design-decisions.md by @Dominic-Padula in #6386
- 6084 Pattern guidance: Add eligibility decision flow and guidance by @Barbara-Denney in #6141
- va-file-input reformats ADR 009 by @Jeana-Clark in #6387
- 📊 Update metrics dashboard data - 2026-05-29 by @Amy-Leadem in #6393
- Fix metrics workflows: add GH_HOST for GHEC auth by @Matthew-Dingee in #6391
- 📊 Update pattern adherence data - 2026-05-29 by @Amy-Leadem in #6396
- fix: migrate remaining department-of-veterans-affairs refs to software org by @Matthew-Dingee in #6394
- Add Figma link and improve alert placement in Complete screening questions by @Barbara-Denney in #6390
- chore: clean up stale department-of-veterans-affairs refs in templates and docs by @Matthew-Dingee in #6395
- Update links.md: Adding guidance to include online tool link by @Lauren-Vocke in #6371
- Update bold-text.md: Revising guidance for label and value pairs by @Lauren-Vocke in #6370
- Metrics: Updates monthly analytics to May 2026 by @Matthew-Dingee in #6429
- Spacing, Typography, Button: Adds relative unit requirements and revises button label character limits by @Matthew-Dingee in #6426
- Imposter metrics: Removes collab-cycle-feedback filter and refreshes data by @Matthew-Dingee in #6430
- 📊 Update metrics dashboard data - 2026-06-05 by @Amy-Leadem in #6434
- Added mock form links by @Jeana-Clark in #6422
- Docs: Complete screening questions edits by @Barbara-Denney in #6398
- Create accessibility test suites for va-checkbox, va-radio, va-select, va-text-input, va-textarea by @Amy-Leadem in #6327
- Clarify breadcrumb adr by @Jeana-Clark in #6444
- Bump @department-of-veterans-affairs/component-library from 56.6.0 to 56.6.1 in the va-design-system-libraries group by @dependabot[bot] in #6454
- VA file input: Adds guidance and examples by @Barbara-Denney in #6445
- Bulleted lists: Add LATCH framework guidance for ordering lists by @Copilot in #6351
- ADR: Complete screening questions pattern by @Barbara-Denney in #6452
- Names: Adds ADR for allowing users to always enter their full first and last name by @Copilot in #6466
- Chore(deps): Bump ws from 8.20.1 to 8.21.0 by @dependabot[bot] in #6470
New Contributors
- @Dominic-Padula made their first contribution in #6386
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-29…Sprint-1
What’s Changed
- chore: update releases for Sprint 28 by @Amy-Leadem in #6306
- Update prefill screenshots by @Jeana-Clark in #6310
- Create index.md: IA section reorg by @Lauren-Vocke in #6283
- Alert: Allow multiple links in alert guidance by @Barbara-Denney in #6166
- chore: migrate remaining github.com URLs to va.ghe.com/software by @Matthew-Dingee in #6312
- Metrics dashboard: Refresh data, fix bugs, add chart tooltips by @Matthew-Dingee in #6313
- Accordion: Add accessibility considerations for multiple accordion groups by @DANIEL-BRADY in #6318
- Button - Segmented: Correct research label mapping for Resources link by @Copilot in #6319
- Adds Architecture Decision Records infrastructure and first ADRs by @Jeana-Clark in #6317
- Search results: Update Results description with Structure and Code guidance by @Copilot in #6167
- Fix link reference in usability studies feedback by @DANIEL-BRADY in #6330
- Mass migration of ADRs from va.gov-team site by @Jeana-Clark in #6331
- Update use-conversational-language.md: Adding unclear pronouns guidance by @Lauren-Vocke in #6276
- Update title-tags.md: Clarifying guidance on title tags and format by @Lauren-Vocke in #6160
- Update form-step-minimal.md: Clarifying guidance for H1s/title tags by @Lauren-Vocke in #6161
- Update form-step.md: Fixing hint text punctuation guidance by @Lauren-Vocke in #6162
- Create april-2026.md: Adding April 2026 file by @Lauren-Vocke in #6304
- Copilot agent: Improves cloud agent instructions by @Matthew-Dingee in #6337
- Alert: Adds mobile expandable alert guidance and updates Storybook embed by @Copilot in #6336
- Fix liquid warnings by @DANIEL-BRADY in #6341
- Adds Pattern ADRs by @Jeana-Clark in #6340
- Bump ws from 8.18.3 to 8.20.1 by @dependabot[bot] in #6345
- Copilot agent: Adds VADS Documentation Writer custom agent by @Matthew-Dingee in #6342
- Bump @department-of-veterans-affairs/component-library from 56.4.0 to 56.5.0 in the va-design-system-libraries group across 1 directory by @dependabot[bot] in #6353
- Breadcrumbs: Adds explicit mobile collapse behavior guidance by @Copilot in #6349
- Update whats-new.md: Adding April 2026 content changes by @Lauren-Vocke in #6346
- Combo Box: Adds placeholder guidance to accessibility considerations by @Copilot in #6350
- File input docs: replace generic Storybook links with scenario-specific story URLs by @Copilot in #6335
- Tag - Status: Add date-based label guidance by @Copilot in #6355
- Link: Updates mobile guidance for form links, platform differences, and action sheet terminology by @Copilot in #6356
- Adds adr skill by @Jeana-Clark in #6348
- Updates primary entry link guidance and form introduction pages by @Jeana-Clark in #6363
- Search: Update search index by @DANIEL-BRADY in #6362
- Add auto_awesome (AI) icon to icon documentation by @DANIEL-BRADY in #6368
- Fix sprite sheet path in preview environments by @DANIEL-BRADY in #6376
- Bump @tootallnate/once from 2.0.0 to 2.0.1 by @dependabot[bot] in #6367
- Updates intro pages guidance to use va-details by @Jeana-Clark in #6378
- Update structure-your-content.md: Updating headings presentation link by @Lauren-Vocke in #6377
- chore: Remove 181 unused images from src/ by @DANIEL-BRADY in #6364
- chore: Remove 3 abandoned draft pages never published by @DANIEL-BRADY in #6366
New Contributors
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-28…Sprint-29
What’s Changed
- Add route change as the definition of page in spa by @Jeana-Clark in #6169
- Bump @department-of-veterans-affairs/component-library from 56.3.0 to 56.4.0 in the va-design-system-libraries group by @dependabot[bot] in #6188
- Workflows: Add gh_host by @DANIEL-BRADY in #6189
- Prevent deployment from overwriting mobile storybook and prototypes by @Amy-Leadem in #6192
- Adding code usage links to point to Storybook by @Jeana-Clark in #6149
- Workflows: Update auth method by @DANIEL-BRADY in #6193
- chore: update releases for Sprint 27 by @Amy-Leadem in #6195
- Update va-telephone accessibility guidance for
mesasageAriaDescribedbyprop usage by @Ryan-Munsch in #6123 - Update unordered-list.md: Changing “break out” to “break up” by @Lauren-Vocke in #6154
- Update CODEOWNERS to reflect new GHEC assignment by @DANIEL-BRADY in #6252
- URL updates: Fix GitHub discussion urls by @Barbara-Denney in #6273
- Update bulleted-lists.md: Adding new ordering and breaking up info by @Lauren-Vocke in #6155
- Update bold-text.md: Updating section title and when to bold guidance by @Lauren-Vocke in #6274
- Update experience-standards.md by @Allison-Christman in #6286
- Update experience-standards.md by @Allison-Christman in #6288
- Bump nokogiri from 1.19.1 to 1.19.3 in the bundler group across 1 directory by @dependabot[bot] in #6292
- Bump @department-of-veterans-affairs/css-library from 0.31.1 to 0.32.0 in the va-design-system-libraries group by @dependabot[bot] in #6295
- Breakpoints: Add tablet-lg 880px to the breakpoints table by @JAMI-GIBBS in #6296
- Accessibility audit - Audit va-button, va-details, va-link and build standalone results pages by @Amy-Leadem in #6194
- Add IA search recommendations example image by @Lauren-Vocke in #6302
- Update icon sprite sheet by @JAMI-GIBBS in #6300
- Update Figma links from deprecated component examples file to current component library by @Barbara-Denney in #6272
- Bump @babel/plugin-transform-modules-systemjs from 7.27.1 to 7.29.4 by @dependabot[bot] in #6305
New Contributors
- @dependabot[bot] made their first contribution in #6188
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-27…Sprint-28
What’s Changed
Fixes
- va-official-gov-banner: update aria attributes by @JAMI-GIBBS in #2133
- va-memorable-date, va-date: fix issue with validation not checking inital field values by @Kerry-Powell in #2132
- va-breadcrumbs: fix typescript errors by @JAMI-GIBBS in #2137
- va-alert-sign-in: suppress expected console.error in invalid variant tests by @JAMI-GIBBS in #2138
- va-link: remove link–center style, align icons using containers/flex by @Kerry-Powell in #2139
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.6.0…v56.6.1
What’s Changed
New Features & Components 🎉
- va-loading-indicator: Adding inline by @Calvin-Cieslak in #1612
- Resolutions: Update and remove stale resolutions by @Kerry-Powell in #2128
Fixes
- Revert “webpack: upgrade to 5.106.2 in all packages (#2099)” by @Kerry-Powell in #2127
- va-link: alignment and text indent by @Edwin-Otero in #2125
- va-file-input: Allow for multiple MIME types per extension by @Matthew-Long6 in #2123
New Contributors
- @Calvin-Cieslak made their first contribution in #1612
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.5.0…v56.6.0
What’s Changed
New Features & Components 🎉
| Change | Author | PR |
|---|---|---|
| webpack: upgrade to 5.106.2 in all packages | @Kerry-Powell | #2099 |
| va-combo-box: add va-input-change event | @Ian-Harrison | #2102 |
Fixes
| Change | Author | PR |
|---|---|---|
| va-statement-of-truth: fix guidance link in Storybook | @JAMI-GIBBS | #2096 |
| va-combo-box: hide clear button when there is no value | @Kerry-Powell | #2093 |
| va-alert: allow onVaComponentDidLoad event name to be called properly | @Kerry-Powell | #2097 |
| va-accordion: fix announcement of state change for expand/collapse all toggles | @Ryan-Munsch | #2111 |
| VaTable sortable prop strips event handlers | @Edwin-Otero | #2094 |
| [va-omb-info]: adds headings to privacy act modal | @Jeana-Clark | #2104 |
| update icon sprite sheet | @JAMI-GIBBS | #2115 |
| va-link: update hover focus border and reverse | @Edwin-Otero | #2110 |
| va-file-input: remove password warning alert, utilize input hint and aria-labels for screen reader password state. | @Ryan-Munsch | #2090 |
| build(deps): bump the npm_and_yarn group across 3 directories with 2 updates | @dependabot[bot] | #2103 |
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.4.0…v56.5.0
April 2026
Content style guide
Page titles and section titles
- Fixed the formatting of the intro text so the last sentence isn’t below the table of contents
- Added a crosslink to the Title tags section
Title tags
Title tags use the H1 as part of the tag. The Title tag section has specific information on what to use for the title tag and how to format it, depending on the context.
- Made minor edits throughout to align with the style guide