ui-review-tahoe

Reviews macOS Tahoe app interfaces for Liquid Glass design, HIG compliance, and accessibility.

70|4|Updated Jul 22, 2025

Search Tags:#accessibility #ui review #macos #swiftui #appkit #liquid glass #hig compliance

Ready to run

npx skills add https://github.com/AlexW00/Zettel --skill ui-review-tahoe-alexw00

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ui-review-tahoe
Source: https://github.com/AlexW00/Zettel/tree/main/.agents/skills/macos-development/ui-review-tahoe
Command: npx skills add https://github.com/AlexW00/Zettel --skill ui-review-tahoe-alexw00

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ensuring a macOS app follows the macOS 26 (Tahoe) Human Interface Guidelines, Liquid Glass design language, and accessibility standards requires deep platform expertise that is easy to miss during development. ## Core Features & Use Cases - Structured UI Audits: Systematically reviews SwiftUI and AppKit interfaces against five reference modules covering Liquid Glass design, macOS Tahoe HIG, SwiftUI patterns, modern AppKit, and accessibility. - Prioritized Feedback: Categorizes findings as Critical, Important, or Nice-to-have, each with the violated guideline, user impact, concrete code fix, and Apple documentation links. - Use Case: Before shipping a macOS 26 note-taking app, submit your SwiftUI views or screenshots to verify VoiceOver support, transparent menu bar integration, toolbar conventions, and Dynamic Type scaling. ## Quick Start Review my macOS app's SwiftUI views for macOS Tahoe HIG compliance and accessibility issues.

Frequently Asked Questions about ui-review-tahoe

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

FAQPage Schema

How do I review my macOS app for Tahoe HIG compliance?▼

Provide your SwiftUI or AppKit view code or screenshots and request a UI review. The review checks window chrome, toolbar design, navigation patterns, menu structure, and keyboard shortcuts against macOS 26 guidelines, returning prioritized findings with code fixes.

What is the Liquid Glass design system in macOS 26?▼

Liquid Glass is the design language for macOS 26 Tahoe, iOS 26, and iPadOS 26 built on transparency, depth, and system materials like .ultraThinMaterial. It features a fully transparent menu bar, subtle shadows, smooth spring animations, and semantic adaptive colors.

Does this review cover both SwiftUI and AppKit code?▼

Yes, the review covers SwiftUI patterns like NavigationSplitView and Table as well as modern AppKit patterns including NSVisualEffectView, NSTableView, and window controllers. It also addresses hybrid integration via NSHostingView and NSViewRepresentable.

What accessibility issues does a macOS UI review check?▼

The review verifies VoiceOver labels and hints, keyboard navigation and focus management, Dynamic Type text scaling, WCAG AA color contrast, Reduce Motion support, and proper accessibility roles for custom controls in both SwiftUI and AppKit.

Are there known SwiftUI bugs on macOS Tahoe to watch for?▼

Yes, documented issues include broken layouts requiring explicit frames and spacing, NSHostingView frame changes not animating smoothly, and some transparency effects rendering incorrectly. Workarounds include explicit animation timing and testing materials on actual Tahoe hardware.