Welcome to Spectrum 2 v1.0! This milestone marks the first stable version of our implementation of the updated Adobe design system. Spectrum 2 delivers modern, refined components with better accessibility, performance, and styling flexibility using style macros. Use our updated search to browse the new components, or visit our migration guide to learn how to upgrade.
Along with this stable version, we have overhauled our documentation website for both React Spectrum and React Aria. The rewritten content is more concise and makes greater use of interactive examples using prop controls. Code examples have been refined to highlight what matters most, and real-world app examples show how all these pieces come together. The new search experience includes image previews and category and library filtering, helping you find what you need faster. There are more component examples, new guides, migration tools, AI-friendly page markdown, and MCP servers, all wrapped in a fresh new look!
As always, this release includes new features and bug fixes, including support for inline editing for TableView. Thank you to all our contributors in this release and from this past year. We hope you enjoy the updates, see you in 2026!
Enhancements
- Accordion
- Image
- Support conditional images - @devongovett - PR
- TableView
- Miscellaneous
- Add style macro properties to Spectrum 2 MCP server - @reidbarber - PR
Fixes
- ActionButton
- Fix XL Avatar size in ActionButton - @reidbarber - PR
- Update ActionButton to use grid area to position NotificationBadge - @yihuiliao - PR
- Disable all ActionButtons when
isDisabledis applied to ActionButtonGroup - @snowystinger - PR
- DateField
- DateField should horizontally scroll when there is not enough room to render - @snowystinger - PR
- Dialog
- Update header and heading font in Dialog - @snowystinger - PR
- FieldGroup
- Form
- Fix passing
UNSAFE_classNameandUNSAFE_style- @devongovett - PR
- Fix passing
- LinkButton
- Modal
- Fix Modal position - @reidbarber - PR
- NumberField
- Prevent screen from shifting when pressing spin buttons on mobile - @snowystinger - PR, PR
- Inherit Form props - @devongovett - PR
- Picker
- Make
isQuietprop public - @yihuiliao - PR - Remove
allowEmptyCollectionprop - @LFDanLu - PR
- Make
- RangeCalendar
- Update
isInvalidstyling - @LFDanLu - PR - Fix style of date range when setting
firstDayOfWeekprop - @yihuiliao - PR
- Update
- SelectBoxGroup
- TableView
- TagGroup
- TextArea
- Toast
- Fix long words from overflowing Toast container - @reidbarber - PR
- Remove type from view transitions - @reidbarber - PR
- Remove
UNSTABLEfrom Toast - @yihuiliao - PR - Improve animation issues in Safari - @devongovett - PR
- TreeView
- Miscellaneous
- Ensure required icon has label when field is required - @LFDanLu - PR
- Support
fontSizeoverrides via style macros - @LFDanLu - PR - Override default React Aria class names for all Spectrum 2 components - @LFDanLu - PR
- Update comment for
staticColorprop - @devonlacross - PR - Update fonts for Arabic and Hebrew - @devongovett - PR
- Add
containerTypeandcontainerNameto style macro - @devongovett - PR - Fix icons not setting default fill color - @devongovett - PR
- Add
use clientto Illustrations - @devongovett - PR