swiftui-design-rules

Audit SwiftUI views for accessibility, design, interaction, and performance compliance.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/smykla-skalski/harness --skill swiftui-design-rules
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swiftui-design-rules
Source: https://github.com/smykla-skalski/harness/tree/main/.claude/skills/swiftui-design-rules
Command: npx skills add https://github.com/smykla-skalski/harness --skill swiftui-design-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill codifies mandatory UX, accessibility, visual design, interaction, and performance rules for SwiftUI surfaces so features ship with consistent quality and meet accessibility requirements.

Core Features & Use Cases

  • Accessibility checklist: VoiceOver labels, Dynamic Type support, contrast ratios, Reduce Motion/Transparency fallbacks, keyboard navigation, and target sizes.
  • Visual and interaction rules: Typography, 8-point spacing grid, dark mode handling, motion timing, feedback/loading/error patterns, and destructive action safeguards.
  • Performance and reliability: 60fps animation targets, launch and scroll performance guidance, memory and network recommendations, and auto-save/undo policies.
  • Use case: Run during code review, QA sign-off, or design review for SwiftUI views, forms, lists, and in-app monitoring UIs to surface violations and remediation steps.

Quick Start

Audit the provided SwiftUI view or screen against the swiftui-design-rules checklist and report any accessibility, design, interaction, or performance violations.

Frequently Asked Questions about swiftui-design-rules

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit SwiftUI views for accessibility and performance compliance?

Audit SwiftUI views by checking VoiceOver labels, Dynamic Type support, contrast ratios, target sizes, Reduce Motion and Reduce Transparency fallbacks, keyboard navigation, animation timing, and scroll performance to identify violations and remediation steps.

What SwiftUI accessibility rules should I check during code review?

Verify VoiceOver labels, Dynamic Type support, contrast ratios, minimum target sizes, keyboard navigation, and Reduce Motion and Reduce Transparency fallbacks during code review to ensure SwiftUI surfaces meet accessibility requirements.

How do I enforce 60fps animation and scroll performance targets in SwiftUI?

Enforce 60fps animation targets in SwiftUI by auditing animation timing, launch and scroll performance, memory usage, and network guidelines to surface violations during feature sign-off workflows.

Does this SwiftUI design checklist apply to both macOS and iOS surfaces?

Yes, the SwiftUI design checklist applies to both macOS and iOS surfaces, auditing forms, lists, modals, and in-app monitoring UIs for visual design, interaction, accessibility, and performance compliance.

What visual and interaction design rules should SwiftUI forms and lists follow?

SwiftUI forms and lists should follow typography guidelines, an 8-point spacing grid, dark mode handling, motion timing, feedback patterns, loading states, error handling, and destructive action safeguards to ensure consistent UX quality.

Why does my SwiftUI UI fail VoiceOver and Dynamic Type accessibility checks?

SwiftUI UIs fail accessibility checks when VoiceOver labels are missing, Dynamic Type is unsupported, contrast ratios fall below thresholds, target sizes are too small, or keyboard navigation and Reduce Motion fallbacks are not implemented.