ios-hig-design — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited ios-hig-design (Agent Skill) and scored it 96/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 1 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 1 flagged
The text {match} tells the agent to skip the normal "ask the user first" gate. Used adversarially it removes the human-in-the-loop check before destructive or sensitive actions, turning a normally-gated agent into a fire-and-forget executor.
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Framework for designing native iOS interfaces that feel intuitive, consistent, and aligned with Apple's design philosophy. Based on Apple's Human Interface Guidelines, the definitive resource for apps that integrate seamlessly with iPhone, iPad, and the Apple ecosystem.
Apple's iOS design philosophy rests on three pillars: clarity (every element legible and purposeful), deference (the interface never overshadows the content it presents), and depth (layering, transitions, and realistic motion convey hierarchy and spatial relationships).
The foundation: The best iOS apps internalize this philosophy rather than following HIG rules mechanically. Native components, system conventions, and platform consistency aren't constraints---they're the reason iOS users trust and enjoy apps that feel like they belong.
Goal: 10/10. Rate iOS interfaces or SwiftUI/UIKit code 0-10 against the principles below. Always state the current score and the specific improvements needed to reach 10/10.
Core concept: iOS devices have specific screen dimensions, safe area insets, and hardware intrusions (notch, Dynamic Island, home indicator) that every layout must respect.
Why it works: When layouts respect safe areas and standard spacing, the app feels native and trustworthy---no content hides behind hardware features, and the visual rhythm matches the platform.
Key insights:
Product applications:
| Context | Layout Pattern | Example |
|---|---|---|
| Status bar | 59pt height, always respected | Time, signal, battery area |
| Navigation bar | 44pt standard row + 58pt large title | Back button, title, actions |
| Content area | Flexible, scrollable, respects safe area | Main app content |
| Tab bar | 49pt height, translucent with blur | 2-5 primary destinations |
| Home indicator | 34pt inset at bottom | System gesture area |
Copy patterns:
VStack { }, which respects safe areas by default.ignoresSafeArea() only for backgrounds and decoration, never interactive contentEthical boundary: Never hide critical content or controls behind hardware intrusions---every device deserves equal access to all functionality.
See: references/navigation.md for detailed navigation bar and tab bar specifications.
Core concept: iOS uses the San Francisco (SF Pro) typeface with semantic text styles that automatically scale for accessibility via Dynamic Type.
Why it works: Semantic styles create consistent hierarchy across the platform, and Dynamic Type lets every user---including those with visual impairments---read at their preferred size without breaking layouts.
Key insights:
Product applications:
| Context | Typography Pattern | Example |
|---|---|---|
| Screen titles | .largeTitle or .title style | Large title collapses on scroll |
| Body content | .body style, 17pt | List items, descriptions |
| Secondary info | .subheadline or .footnote | Timestamps, metadata |
| Tab labels | 10pt SF text | Tab bar item labels |
| Buttons | .body weight semibold | Primary action text |
Copy patterns:
.font(.title), .font(.body), .font(.caption) instead of hardcoded sizes; @ScaledMetric for custom spacing that scalesEthical boundary: Never disable Dynamic Type or fix font sizes that block accessibility scaling---every user deserves readable text.
See: references/typography.md for complete text styles, font sizes, and Dark Mode typography rules.
Core concept: iOS provides semantic system colors that automatically adapt between light and dark appearances while preserving contrast and hierarchy.
Why it works: Semantic colors maintain readability across appearances without manual intervention, so Dark Mode users get a first-class experience and the app feels polished and native.
Key insights:
Color(.label), Color(.secondaryLabel), Color(.systemBackground) instead of hardcoded colorsColor(.systemBlue) is the default tint; .systemRed for destructive actions; .systemGreen for successProduct applications:
| Context | Color Pattern | Example |
|---|---|---|
| Primary text | Color(.label) | Adapts white/black per mode |
| Secondary text | Color(.secondaryLabel) | 60% opacity in both modes |
| Backgrounds | Color(.systemBackground) / .secondarySystemBackground | Layered depth |
| Destructive actions | Color(.systemRed) | Delete buttons, warnings |
| Interactive tint | App accent color or .systemBlue | Links, toggle states |
Copy patterns:
.preferredColorScheme(.light) and .dark in previews to test both modes side by sideEthical boundary: Dark Mode is not optional polish---never ship an app that is unreadable or broken in it.
See: references/colors-depth.md for semantic colors, Dark Mode palette, and contrast ratio guidelines.
Core concept: iOS uses a layered navigation model: tab bars for primary destinations, navigation stacks for hierarchical drilling, and modals for focused tasks.
Why it works: Consistent navigation means users always know where they are, how they got there, and how to go back; violating these patterns makes the app feel foreign on iOS.
Key insights:
Product applications:
| Context | Navigation Pattern | Example |
|---|---|---|
| App structure | Tab bar with 3-5 tabs | Home, Search, Profile |
| Content hierarchy | Push navigation (drill-down) | List > Detail > Edit |
| Focused tasks | Modal presentation | Compose, settings, filters |
| Search | Pull-down search bar | Spotlight-style search |
| Split view | iPad sidebar + detail | Mail, Notes on iPad |
Copy patterns:
NavigationStack (not deprecated NavigationView) in SwiftUIEthical boundary: Never trap users in flows without a clear exit---every screen needs an obvious way back or out.
Core concept: iOS provides a rich library of native controls (buttons, lists, toggles, pickers, menus, text fields) that users already understand and expect.
Why it works: Native controls ship with built-in accessibility, haptics, and learned interaction patterns; custom controls create friction and miss edge cases Apple already solved.
Key insights:
.emailAddress, .phonePad, .URL); use .textContentType for autofillProduct applications:
| Context | Control Pattern | Example |
|---|---|---|
| Forms | Native text fields with proper keyboard types | Email field with @ keyboard |
| Settings | Grouped list with toggles, disclosure | iOS Settings style |
| Selection | Picker, segmented control, or action sheet | Date picker, sort options |
| Destructive actions | Red button + confirmation alert | "Delete Account" flow |
| Context actions | Long press menu or swipe actions | Edit, share, delete on row |
Copy patterns:
.keyboardType(.emailAddress) with .textContentType(.emailAddress).alert() or .confirmationDialog(); use .swipeActions on list rowsEthical boundary: Never disguise ads as native controls or make destructive actions easy to trigger accidentally.
See: references/components.md for buttons, lists, input controls, menus, and confirmation dialogs. See also: references/keyboard-input.md for keyboard types and input patterns.
Core concept: iOS has world-class accessibility features (VoiceOver, Dynamic Type, Switch Control, Voice Control), and every app must support them as a first-class concern.
Why it works: Over 1 billion people live with some form of disability, and accessible apps benefit everyone (larger text in sunlight, VoiceOver while driving). App Store guidelines require it.
Key insights:
.accessibilityLabel; use .accessibilityValue for state and .accessibilityHint for effect.accessibilityElement(children: .combine)Product applications:
| Context | Accessibility Pattern | Example |
|---|---|---|
| Icons | .accessibilityLabel("Favorite") | Heart icon with label |
| Sliders | .accessibilityValue("\(Int(volume * 100))%") | Volume control |
| Buttons | .accessibilityHint("Shares this item") | Share button |
| Groups | .accessibilityElement(children: .combine) | Avatar + name row |
| Images | Decorative: .accessibilityHidden(true) | Background patterns |
Copy patterns:
Ethical boundary: Shipping an inaccessible app excludes real people---treat VoiceOver testing as seriously as visual testing.
See: references/accessibility.md for VoiceOver implementation, Dynamic Type support, and the accessibility checklist.
Core concept: iOS uses SF Symbols as the standard icon system and requires app icons in specific sizes with the signature superellipse ("squircle") mask applied automatically.
Why it works: SF Symbols align perfectly with San Francisco text, scale with Dynamic Type, and adapt to weights and sizes; consistent iconography makes the interface feel cohesive and native.
Key insights:
Image(systemName:)) for all standard icons---they scale with textProduct applications:
| Context | Icon Pattern | Example |
|---|---|---|
| Tab bar | SF Symbols, filled variant for selected | house.fill, magnifyingglass |
| Navigation bar | SF Symbols at regular weight | gear, plus, ellipsis |
| List accessories | SF Symbols, secondary color | chevron.right, checkmark |
| App icon | 1024px square, simple bold design | Single recognizable glyph |
Copy patterns:
Image(systemName: "heart.fill"); apply .symbolRenderingMode(.hierarchical) for multi-color depth.imageScale(.large) or .font()Ethical boundary: Never use icons that suggest functionality that doesn't exist or contradict iOS conventions (trash = delete, not archive).
See: references/app-icons.md for icon size tables, shape specifications, and design guidelines.
Core concept: iOS defines standard gestures (swipe back, pull to refresh, long press for context menu) and haptic feedback patterns that must be respected and never overridden.
Why it works: Gestures are muscle memory---overriding swipe-back or repurposing pull-to-refresh disorients users. Haptics provide invisible confirmation that an action registered.
Key insights:
Product applications:
| Context | Gesture/Haptic Pattern | Example |
|---|---|---|
| Navigation | Swipe right from left edge | System back gesture |
| Modals | Swipe down to dismiss | Sheet dismissal |
| Lists | Pull to refresh, swipe for actions | Refresh content, delete row |
| Confirmation | .success haptic on completion | Payment confirmed |
| Selection | Selection haptic on toggle/pick | Picker wheel scroll |
Copy patterns:
UIImpactFeedbackGenerator(style: .medium) for physical interactions; UISelectionFeedbackGenerator() for UI state changesUINotificationFeedbackGenerator() with .success, .warning, .error for outcomes.prepare() before triggering haptics to minimize latencyEthical boundary: Haptic feedback should confirm, never coerce.
See: references/gestures.md for the standard gesture table, haptic patterns, and animation guidelines.
| Mistake | Why It Fails | Fix |
|---|---|---|
| Overriding standard gestures | Breaks muscle memory for swipe-back, pull-refresh | Use system gestures as intended; custom gestures only for supplementary actions |
| Touch targets under 44pt | Mis-taps, frustration, accessibility failures | Make all interactive elements at least 44 x 44pt |
| Ignoring safe areas | Content hidden behind notch, Dynamic Island, home indicator | Respect safe area insets; .ignoresSafeArea() only for backgrounds |
| Using Android patterns on iOS | Hamburger menus, top tabs, FABs feel foreign | Use tab bars, bottom sheets, native iOS components |
| Skipping Dark Mode | Broken layouts, unreadable text for Dark Mode users | Use semantic colors; test both appearances |
| Hardcoding font sizes | Breaks Dynamic Type, excludes low-vision users | Use semantic text styles (.title, .body, .caption) throughout |
| Low contrast text | Fails WCAG AA; unreadable in sunlight | Maintain 4.5:1 minimum; test with Increase Contrast |
| Not testing on real devices | Simulator misses performance, haptics, safe area edge cases | Test on physical devices at smallest and largest sizes |
Audit any iOS interface design:
| Question | If No | Action |
|---|---|---|
| Does the layout respect safe areas on all device sizes? | Content hidden behind hardware | Audit on iPhone SE and Pro Max; fix insets |
| Are all touch targets at least 44 x 44pt? | Mis-taps and accessibility failures | Increase tap areas; .frame(minWidth: 44, minHeight: 44) |
| Does the app work fully in Dark Mode? | Broken/unreadable UI for Dark Mode users | Replace hardcoded colors with semantic system colors |
| Does text scale properly with Dynamic Type? | Excludes low-vision users | Use semantic text styles; test at largest setting |
| Can a VoiceOver user complete every task? | App inaccessible to blind users | Add labels, values, hints to all interactive elements |
| Are navigation patterns native iOS? | App feels foreign | Replace hamburger menus with tab bars; standard push/modal navigation |
For the complete guidelines, platform-specific guidance, and latest updates:
The Apple Human Interface Guidelines are written and maintained by Apple's Human Interface Design team, one of the most influential design organizations in technology. First published in 1984 alongside the original Macintosh, the HIG established principles---direct manipulation, consistency, user control---that defined graphical interface design and have evolved through iPhone, iPad, Apple Watch, and Vision Pro. It remains freely available at developer.apple.com as the essential reference for Apple platforms.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.