Design System · 15 of 25
Feedback
Toasts, alerts and banners.
Feedback philosophy
Feedback should be timely, clear and dismissible.
Feedback components communicate state changes and results to users. They are assertive enough to get attention but unobtrusive enough not to block interaction unnecessarily. A toast auto-dismisses after a timeout. An alert or banner remains until the user dismisses it. A modal or drawer blocks until addressed. The duration and mode of dismissal should be clear from the design and the microcopy.
Rules
Toasts auto-dismiss after a set timeout.
Alerts and banners remain until dismissed by the user.
Modals and drawers block interaction until addressed.
Microcopy is clear and actionable.
Respect prefers-reduced-motion for auto-dismissing toast.
Toasts alerts banners and modals
Feedback atoms
The smallest feedback building blocks.
Feedback atoms are the fundamental UI primitives: button, icon, close icon, progress bar, spinner. Each atom ships with every state and styles from design tokens. See <a href="/design-system/atomic-design#atoms">Atomic design → Atoms</a> for the canonical atom definition.
Examples
Button (primary, secondary, ghost)
Icon (info, warning, error, success)
Close icon (dismiss control)
Progress bar, spinner
Rules
Provide visible focus indicators.
Basic building blocks: buttons, icons, progress, spinners.
Feedback molecules
Groups of atoms that form feedback patterns.
Feedback molecules combine atoms into purposeful patterns. A button and icon become a toast trigger. An icon and text become an alert. A progress bar and text become a status update. See <a href="/design-system/atomic-design#molecules">Atomic design → Molecules</a> for the canonical molecule definition.
Examples
Toast trigger (button + icon)
Alert (icon + message + action)
Status bar (progress + text)
Rules
Use appropriate ARIA roles and labels.
Groups of atoms that form useful feedback patterns
Feedback organisms
Larger feedback regions made of molecules.
Feedback organisms are distinct interface regions: a toast container, an alert banner, a modal drawer. They can hold state and accept data through props but their visual building blocks all come from lower levels. See <a href="/design-system/atomic-design#organisms">Atomic design → Organisms</a> for the canonical organism definition.
Examples
Toast container (multiple toasts stacking)
Alert banner (persistent at top of page)
Modal drawer (forms confirmation)
Rules
Handle open, loading and error states explicitly.
Distinct regions of feedback built from lower-level components
Accessibility
Feedback must work for everyone.
Feedback components must be operable via keyboard and screen reader friendly. Toasts should announce their message to screen readers. Alerts and banners should have dismiss buttons with clear labels. Modals and drawers should trap focus and provide escape key handling.
Rules
Toasts announce their message to screen readers via ARIA live regions.
Alerts and banners have dismiss buttons with clear label text.
Modals and drawers trap focus and provide escape key handling.
Never use color alone to convey status.
Respect prefers-reduced-motion.
ARIA live regions and dismiss patterns
Practical guidelines
Tips for applying feedback patterns consistently.
Start with the most common pattern toast for transient messages. Add alerts for important but non-blocking information. Use modals or drawers only for critical interactions that require user attention. Always test with keyboard and screen reader.
Do
Use clear microcopy. Set appropriate timeouts. Provide dismiss buttons.
Don't
Do not block the main thread with long-running init. Do not skip screen reader announcement.
Rules
Start with toast for transient messages.
Add alerts for important but non-blocking information.
Use modals or drawers only for critical interactions.
Always test with keyboard and screen reader.
Checklist
Before shipping your feedback system.
Timing
Toasts auto-dismiss after appropriate timeout. Alerts and banners remain until dismissed.
Accessibility
ARIA live regions for toasts alerts. Focus management for modals drawers. Color is not the only means of conveying status.
Clarity
Microcopy is clear and actionable. Status is perceivable without relying on color alone.