apple-ui-auditlisted

# apple-ui-audit Structured review of an Apple-platform interface against the Human Interface Guidelines and current Liquid Glass guidance (iOS 26 / 2025-2026). The report lists findings with severity and a fix direction. ## Scope SwiftUI, UIKit, AppKit screens; mockups intended for App Store submission; cross-platform (iOS/iPadOS/macOS/tvOS/watchOS/visionOS) consistency checks. Web UI that only *looks* iOS-like is out of scope (use `ui-slop-remover` / `ui-craft-rules`). ## 1. Navigation and hierarchy - Content layer vs navigation layer clearly separated. Tab bars, sidebars, toolbars sit in the functional layer above content. - One obvious primary path per screen; no competing equal-weight actions. - Standard back / dismiss patterns; no custom chrome that fights system gestures. - Search and navigation work the same way across iPhone, iPad, Mac where the HIG expects it. - Sidebar / inspector safe areas: content peeks correctly; nothing clipped under Liquid Glass. ## 2. Liquid Glass (when targeting latest OS) Primary references: Apple "Adopting Liquid Glass", HIG Materials. | Check | Fail signal | |---|---| | Use system components first | Custom opaque bars fighting the system material | | Glass on controls/navigation, not content layer | Decorative glass cards in body content | | Sparingly on custom controls | Every cell frosted | | Regular vs clear variant | Clear over bright text without dimming | | Reduce Transparency path | Broken layout when the setting strips bl