# Human Interface Guidelines

> Apple's comprehensive design principles and standards for creating consistent, intuitive experiences across all platforms

- Skill: `lev-os/human-interface-guidelines` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lev-os/human-interface-guidelines`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lev-os/human-interface-guidelines/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lev-os (https://skillmd.com/u/lev-os)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/lev-os/human-interface-guidelines

---


# Human Interface Guidelines (HIG)

## OVERVIEW
Apple's comprehensive design principles and standards for creating consistent, intuitive experiences across iOS, macOS, watchOS, tvOS, and visionOS. Unified in 2024 from platform-specific guides. Grounded in Clarity, Deference, and Depth principles. Following HIG increases App Store approval rates and ensures native platform feel.

**Why this matters**: Establishes user trust through familiarity, reduces development time with standard components, ensures accessibility compliance, aligns with platform conventions users expect.

## WHEN TO USE
- Designing applications for any Apple platform (iOS, macOS, watchOS, tvOS, visionOS)
- Establishing design system foundations for Apple ecosystem
- Making interface decisions requiring platform consistency
- Preparing apps for App Store submission and review
- Onboarding designers/developers new to Apple platforms
- Resolving design conflicts via canonical standards
- Ensuring accessibility compliance across platforms

**Trigger**: Building for Apple platforms or need to align with user expectations from Apple ecosystem.

## KEY PRINCIPLES

### 1. Clarity
**Concept**: Text is legible at every size, icons are precise, functionality is obvious, adornments are subtle and appropriate.

**Application**:
- Use system fonts (SF Pro, SF Compact) for optimal legibility
- Negative space, color, typography create clear hierarchy
- Interactive elements clearly indicate affordances
- Critical information stands out without decoration

**Implementation**: Dynamic Type for scalable text, SF Symbols for icons, semantic colors that adapt to light/dark mode.

### 2. Deference
**Concept**: UI helps people understand and interact with content but never competes with it.

**Application**:
- Fluid motion and crisp interface that recede during content consumption
- Translucent backgrounds that provide context without obscuring
- Minimal chrome that highlights content, not UI elements
- Full-screen experiences when appropriate

**Implementation**: Reduce UI chrome in reading modes, use translucent navigation bars, let content bleed to edges.

### 3. Depth
**Concept**: Visual layers and realistic motion convey hierarchy and facilitate understanding.

**Application**:
- Distinct visual layers communicate relationships
- Transitions provide sense of spatial awareness
- Shadows and translucency suggest elevation
- Parallax and physics-based animations feel natural

**Implementation**: Navigation hierarchies with depth, modal presentations over context, spring animations.

## EXECUTION STEPS

### Phase 1: Foundation Setup
1. **Study platform conventions** - Review HIG for target platform (iOS/macOS/watchOS/tvOS/visionOS)
2. **Establish visual system** - Adopt SF Symbols, system fonts, semantic colors
3. **Choose navigation pattern** - Tab bar (iOS), sidebar (macOS), complications (watchOS)
4. **Define accessibility baseline** - Dynamic Type support, VoiceOver labels, contrast ratios

### Phase 2: Component Implementation
5. **Use system components** - UIKit/AppKit/SwiftUI standard controls
6. **Implement dark mode** - Use semantic colors, test both appearances
7. **Add platform gestures** - Swipe actions, long press, platform-specific interactions
8. **Configure haptic feedback** - iOS haptics for meaningful moments

### Phase 3: Refinement & Testing
9. **Test accessibility** - VoiceOver, Dynamic Type (up to AX sizes), Reduce Motion
10. **Validate across devices** - All iPhone sizes, iPad orientations, Mac screen sizes
11. **Review against HIG** - Component usage, interaction patterns, visual hierarchy
12. **App Store preparation** - Screenshots, descriptions, compliance checklist

## SUCCESS METRICS
- **App Store approval** - First-submission approval rate ≥ 85%
- **Accessibility audit pass** - ≥ 95% compliance with automated/manual tests
- **User onboarding time** - Minimal learning curve for platform-familiar users
- **Platform NPS** - Higher satisfaction for "native-feeling" apps
- **Development velocity** - 40-60% reduction in custom UI development

## REAL-WORLD EXAMPLES

### Apple Mail (iOS)
Standard navigation bar with compose button (top-right), swipe gestures for delete/archive/flag, unified inbox with SF Symbols, full VoiceOver support.

### Xcode (macOS)
macOS window patterns with source list sidebar, tabbed documents, inspector panels, extensive keyboard shortcuts—hallmarks of macOS design.

### Fitness (watchOS)
Complications on watch face for glanceable data, Digital Crown scrolling, haptic feedback for achievements, SF Compact Rounded for tiny screen.

### Apple TV App (tvOS)
Focus-driven navigation, parallax on focused items, Siri Remote gestures, large high-contrast text readable from 10+ feet.

### Vision Pro (visionOS)
Spatial windows in 3D space, gaze + gesture input, depth hierarchy with z-axis, fully immersive environments.

## ANTI-PATTERNS
**What NOT to do**:
- **Ignoring platform conventions** - One-size-fits-all UI that violates iOS/macOS differences
- **Custom components without reason** - Reinventing buttons/pickers breaks accessibility/dark mode
- **Skipping accessibility testing** - Designing only for default settings excludes 25% of users
- **Inconsistent visual language** - Mixing custom icons with SF Symbols creates disjointed feel
- **Over-designing for novelty** - Unnecessary animations/gestures degrade performance
- **Breaking standard gestures** - Swipe behavior that conflicts with system expectations
- **Fixed text sizes** - Not supporting Dynamic Type limits accessibility

## EDGE CASES
- **Cross-platform apps** - Respect iOS vs. macOS interaction models (touch vs. pointer)
- **Games** - May deviate from HIG but accessibility still required
- **Professional tools** - Custom UI justified for specialized workflows (Final Cut Pro)
- **Branded experiences** - Custom visuals OK if interaction patterns remain standard
- **iPad multitasking** - Support split view, slide over, drag and drop

## INTEGRATION
**Pairs well with**:
- **SwiftUI/UIKit/AppKit** - Native frameworks implement HIG by default
- **SF Symbols** - 5,000+ icons designed for Apple platforms
- **Design tokens** - System color/typography tokens
- **Accessibility APIs** - VoiceOver, Dynamic Type, Reduce Motion
- **Figma/Sketch kits** - Official Apple design templates

**Contrasts with**:
- **Material Design** - Google's design system for Android/web
- **Fluent Design** - Microsoft's design system for Windows
- **Custom design systems** - Bespoke vs. platform-standard approach

## 2025 UPDATE: Liquid Glass Design Language
Announced for iOS 26, iPadOS 26, macOS 26, watchOS 26, tvOS 26:
- Most significant visual redesign since 2013
- Translucent UI components with "optical qualities of glass"
- Refraction effects that react to motion, content, inputs
- Rounded, fluid elements with depth and responsiveness
- Emphasis on depth, translucency, and tactile feedback

## TOOLS & RESOURCES
- **Official site**: developer.apple.com/design/human-interface-guidelines
- **SF Symbols app**: 5,000+ configurable icons
- **Design kits**: Official Figma/Sketch UI templates
- **Accessibility Inspector**: Xcode tool for auditing compliance
- **WWDC sessions**: Annual design updates and best practices
- **Apple Design Awards**: Showcase of exemplary implementations

## FURTHER READING
- **Primary Source**: Apple HIG documentation (developer.apple.com/design)
- **WWDC Sessions**: "What's New in HIG", platform-specific design talks
- **Related**: *Designing for iOS* - Apple's design resources
- **Accessibility**: Apple Accessibility Programming Guide
- **Advanced**: Apple Design Awards case studies

## SCORING RATIONALE
**Total: 49/50**

| Criterion | Score | Reasoning |
|-----------|-------|-----------|
| Practitioner | 10/10 | Apple ships billions of devices; HIG defines platform standards |
| Clarity | 10/10 | Comprehensive docs, code examples, design kits, platform-specific guidance |
| ROI | 10/10 | Higher App Store approval, 40-60% faster development, accessibility built-in |
| Novelty | 9/10 | Continuously evolving (Liquid Glass 2025); sets industry standards |
| Cross-Domain | 10/10 | Works across iOS, macOS, watchOS, tvOS, visionOS, accessories |

**Evidence**: App Store ecosystem, billions of devices, continuous evolution (unified HIG 2024, Liquid Glass 2025), industry-leading accessibility standards.