feat(design-system): Add UI primitives, tests, and gallery - #438
Merged
IbrahimIjai merged 1 commit intoJul 26, 2026
Conversation
Add TokenAvatar and TokenPair components with accessible labeling and support for image/fallback states. Implements all five transaction status states with proper ARIA live regions and accessible action buttons. Creates development-only design system gallery route showing all components in various states with theme and viewport controls. Adds comprehensive accessibility test harness using vitest-axe for all interactive primitives including keyboard behavior, ARIA attributes, and state management tests. Resolves #430 Resolves #431 Resolves #432 Resolves #433
|
@collinsadi is attempting to deploy a commit to the Ijai's projects Team on Vercel. A member of the Team first needs to authorize it. |
|
@collinsadi Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits. You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Added comprehensive design system components and accessibility testing infrastructure for SO4's shared UI library.
Issues Resolved
Closes #430
Closes #431
Closes #432
Closes #433
Changes
#430 - Add TokenPair and TokenAvatar primitive
Created reusable token avatar component with support for images, fallback initials, and multiple sizes (xs, sm, md, lg, xl, 2xl). Includes TokenPair component for overlapping token visuals with proper accessibility labels distinguishing between decorative and meaningful usage.
#431 - Add TransactionStatus pattern
Implemented comprehensive transaction status component supporting five states: signing, submitting, confirming, success, and failed. Each state has semantic labels, proper ARIA live regions to avoid noisy updates, explorer links with action callbacks, and retry functionality with proper error messaging.
#432 - Add design-system development gallery route
Created a development-only route showing all UI components in various states (normal, disabled, loading, invalid, empty). Includes theme switching (light/dark), viewport simulation (mobile/tablet/desktop), linkable sections, and stress tests with long content examples.
#433 - Add accessibility tests for all UI primitives
Established comprehensive test harness using vitest-axe that checks every interactive primitive for WCAG violations. Tests cover keyboard behavior for menus, tabs, dialogs, sliders, and form fields. All tests verify proper ARIA attributes, focus management, and state transitions.
Test Coverage
Documentation
Updated UI package README with component list, testing instructions, and usage examples.