Release Notes

We’re excited to announce that the New York State Design System is now live on NPM! 🎉 You can explore and install our published packages here: NYS Design System on NPM. This release includes two new components—<nys-textarea> and <nys-toggle>—and significant improvements to our build and publishing workflows.

What's New

New Component: nys-textarea

Description: UI element for entering multiline text input.

Features:

• Height adjusts automatically based on content or can be set manually via the rows property
• Supports max length (specify a maximum number of characters)
• Supports a label and a description, with a label positioned at the top of the input and optional description text beneath it. (This is a standard pattern for input elements across the design system.)
• Includes validation support, like required fields, regex patterns, and more to match form requirements

Created by Emily Gorelik (@emilygorelik) in #100

New Component: nys-toggle

Description: Toggle switch for binary options (on/off). Recommended for cases where the action is binary, such as enabling/disabling settings, but nys-checkbox is preferred for more complex selections.

Features:

• Includes small (sm) and medium (md, default) sizes. Font sizes and spacing adjust accordingly.
• Description can be set either via the description property or a slot
• Icons help improve the understandability of the toggle, but can be disable with NoIcons boolean property
• Use theform attribute to associate toggle with a <form> for submission handling
• Includes ARIA roles and supports keyboard navigation, screen reader compatibility, and visual focus indicators
• Emits standard change, focus, blur, and keydown events

Created by Robert Chen (@NovaCat35) in #94

Maintenance and Fixes

• Test builds are now mandatory for PR merges into main - @esteinborn #126
• Optimized build processes, scoped all packages to [@nysds](https://github.com/its-hcd/nysds), and created NPM publishing workflow - @plasticmind #120
• Simplified package.json configs and introduced a pre-built step for Storybook - @plasticmind #128

Related issues

• <nys-toggle>-related issues: #68 #81 #94 #127 #129
• <nys-textarea>-related issues: #83 #98 #100

For full component updates, bug fixes, and the detailed changelog:

See the full developer release notes for v0.0.4-alpha →