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.mdsource 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
| File | Content | Size |
|---|---|---|
| hig-index.md | Full HIG table of contents | 11KB |
| designing-for-ios.md | iOS design principles | 5KB |
Foundations
| File | Content | Size |
|---|---|---|
| app-icons.md | App icon design guidelines | 14KB |
| color.md | Color usage and system colors | 17KB |
| typography.md | Fonts, text styles, Dynamic Type | 17KB |
| layout.md | Layout principles, safe areas | 21KB |
| materials.md | Materials, blur effects, vibrancy | 14KB |
| motion.md | Animation principles | 9KB |
| accessibility.md | Accessibility best practices | 19KB |
| sf-symbols.md | SF Symbols usage | 21KB |
Patterns
| File | Content | Size |
|---|---|---|
| onboarding.md | Onboarding flows | 6KB |
| modality.md | Modal presentations | 7KB |
| launching.md | App launch experience | 6KB |
| feedback.md | User feedback patterns | 5KB |
| playing-haptics.md | Haptic feedback | 10KB |
| searching.md | Search patterns | 7KB |
| settings.md | Settings patterns | 7KB |
Components - Navigation
| File | Content | Size |
|---|---|---|
| tab-bars.md | Tab bar design | 11KB |
| navigation-bars.md | Navigation bar patterns | 17KB |
| toolbars.md | Toolbar design | 17KB |
| sidebars.md | Sidebar patterns | 8KB |
Components - Presentation
| File | Content | Size |
|---|---|---|
| sheets.md | Sheet presentations | 11KB |
| alerts.md | Alert dialogs | 10KB |
| action-sheets.md | Action sheets | 4KB |
| menus.md | Menu design | 14KB |
Components - Controls
| File | Content | Size |
|---|---|---|
| buttons.md | Button styles and usage | 17KB |
| lists-and-tables.md | List and table patterns | 9KB |
| toggles.md | Toggle/switch design | 9KB |
| pickers.md | Picker controls | 6KB |
| sliders.md | Slider controls | 6KB |
| steppers.md | Stepper controls | 2KB |
| text-fields.md | Text input fields | 6KB |
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
- Search this skill's local
files first..md - If the topic is not here, check the other installed Apple skills you have available by their names, descriptions, or
frontmatter, then grep their local files. This is faster and uses less context than fetching new docs from the internet.SKILL.md - If no installed skill has the page, use the relevant Human Interface Guidelines path with the
Markdown mirror. For example,sosumi.ai
maps to/design/human-interface-guidelines/buttons
.https://sosumi.ai/design/human-interface-guidelines/buttons
Common HIG Doc Paths
| Topic | URL Path |
|---|---|
| Full Index | |
| iOS Design | |
| iPadOS Design | |
| macOS Design | |
| App Icons | |
| Color | |
| Typography | |
| Layout | |
| Accessibility | |
| SF Symbols | |
| Buttons | |
| Tab Bars | |
| Navigation Bars | |
| Sheets | |
| 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