Core principles that guide every design decision in NH-UI
1. Clarity Above All
Every interface element must have a clear purpose and meaning.
2. Relentless Consistency
Similar things should look and behave similarly across the system.
3. Accessibility is Universal
Great design works for everyone, regardless of their abilities.
4. Performance is a Feature
Fast interfaces feel more responsive and trustworthy.
Semantic Props
Props use clear, semantic names that describe intent rather than implementation.
✓ isLoading vs showSpinner
✓ isDisabled vs disabled
✓ startContent vs leftIcon
Consistent APIs
Similar components share similar prop patterns.
Common Props
sizecolorvariantisDisabledclassNameSize Values
Design Process
Research
Understand user needs and business requirements
Design
Create solutions aligned with design principles
Validate
Test with users and iterate based on feedback
Quality Standards
Code Quality
✓ 100% TypeScript coverage
✓ Comprehensive unit tests
✓ Automated accessibility testing
✓ Performance benchmarks
Design Quality
✓ WCAG 2.1 AA compliance
✓ Cross-platform testing
✓ Performance optimization
✓ User testing validation