Apple-skills hig

API reference: Apple Human Interface Guidelines. Query for design patterns, UI components, accessibility, color, typography, layout, haptics.

install
source · Clone the upstream repo
git clone https://github.com/vabole/apple-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/vabole/apple-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/hig" ~/.claude/skills/vabole-apple-skills-hig && rm -rf "$T"
manifest: skills/hig/SKILL.md
source content

Human Interface Guidelines Reference

Comprehensive reference for designing interfaces that follow Apple's Human Interface Guidelines.

Downloaded Reference Files

All key HIG documentation is available locally (grep-friendly):

Getting Started

FileContentSize
hig-index.mdFull HIG table of contents11KB
designing-for-ios.mdiOS design principles5KB

Foundations

FileContentSize
app-icons.mdApp icon design guidelines14KB
color.mdColor usage and system colors17KB
typography.mdFonts, text styles, Dynamic Type17KB
layout.mdLayout principles, safe areas21KB
materials.mdMaterials, blur effects, vibrancy14KB
motion.mdAnimation principles9KB
accessibility.mdAccessibility best practices19KB
sf-symbols.mdSF Symbols usage21KB

Patterns

FileContentSize
onboarding.mdOnboarding flows6KB
modality.mdModal presentations7KB
launching.mdApp launch experience6KB
feedback.mdUser feedback patterns5KB
playing-haptics.mdHaptic feedback10KB
searching.mdSearch patterns7KB
settings.mdSettings patterns7KB

Components - Navigation

FileContentSize
tab-bars.mdTab bar design11KB
navigation-bars.mdNavigation bar patterns17KB
toolbars.mdToolbar design17KB
sidebars.mdSidebar patterns8KB

Components - Presentation

FileContentSize
sheets.mdSheet presentations11KB
alerts.mdAlert dialogs10KB
action-sheets.mdAction sheets4KB
menus.mdMenu design14KB

Components - Controls

FileContentSize
buttons.mdButton styles and usage17KB
lists-and-tables.mdList and table patterns9KB
toggles.mdToggle/switch design9KB
pickers.mdPicker controls6KB
sliders.mdSlider controls6KB
steppers.mdStepper controls2KB
text-fields.mdText input fields6KB

Searching the Docs

# Find color guidance
grep -i "semantic" color.md

# Find button styles
grep -i "bordered" buttons.md

# Find haptic patterns
grep -i "notification" playing-haptics.md

# Browse the full HIG index
grep -i "navigation" hig-index.md

Fetching More Docs

  1. Search this skill's local
    .md
    files first.
  2. If the topic is not here, check the other installed Apple skills you have available by their names, descriptions, or
    SKILL.md
    frontmatter, then grep their local files. This is faster and uses less context than fetching new docs from the internet.
  3. If no installed skill has the page, use the relevant Human Interface Guidelines path with the
    sosumi.ai
    Markdown mirror. For example,
    /design/human-interface-guidelines/buttons
    maps to
    https://sosumi.ai/design/human-interface-guidelines/buttons
    .

Common HIG Doc Paths

TopicURL Path
Full Index
human-interface-guidelines
iOS Design
human-interface-guidelines/designing-for-ios
iPadOS Design
human-interface-guidelines/designing-for-ipados
macOS Design
human-interface-guidelines/designing-for-macos
App Icons
human-interface-guidelines/app-icons
Color
human-interface-guidelines/color
Typography
human-interface-guidelines/typography
Layout
human-interface-guidelines/layout
Accessibility
human-interface-guidelines/accessibility
SF Symbols
human-interface-guidelines/sf-symbols
Buttons
human-interface-guidelines/buttons
Tab Bars
human-interface-guidelines/tab-bars
Navigation Bars
human-interface-guidelines/navigation-bars
Sheets
human-interface-guidelines/sheets
Alerts
human-interface-guidelines/alerts

Quick Reference

Button Styles (iOS)

  • Plain - Text only, minimal visual weight
  • Gray - Gray background, for secondary actions
  • Tinted - Tinted background with accent color
  • Filled - Solid background, for primary actions
  • Bordered - Outlined with border
  • Bordered Prominent - Filled background, high prominence

Haptic Feedback Types

  • Selection - Light tap for selection changes
  • Impact - Light/medium/heavy/rigid/soft for collisions
  • Notification - Success/warning/error for outcomes

Safe Areas

  • Always respect safe areas for content
  • Extend backgrounds edge-to-edge
  • Place interactive elements within safe areas

Sources

Apple Documentation

WWDC Sessions