justinwetch/HIGAgentSkills

![Apple HIG reference library](https://raw.githubusercontent.com/justinwetch/HIGAgentSkills/main/docs/readme-graphics/2026-09-12/01-header-light.png)

[![Watch the demo](https://img.youtube.com/vi/jnD82EqZ2VQ/maxresdefault.jpg)](https://www.youtube.com/watch?v=jnD82EqZ2VQ)

Install the apple-hig skill for me from https://github.com/justinwetch/HIGAgentSkills.git

![/duo redesigns your app for iPhone Duo: an open iPhone Duo on a table showing a record library in four columns](https://raw.githubusercontent.com/justinwetch/HIGAgentSkills/main/docs/readme-graphics/2026-09-27/02-duo-release.jpg)

![An iPhone Duo half folded on a table, Now Playing split across the fold: the turntable on the raised half, the controls on the flat half](https://raw.githubusercontent.com/justinwetch/HIGAgentSkills/main/docs/readme-graphics/2026-09-27/03

Distilled from [Apple's Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines). The Duo checklist also paraphrases Apple's iPhone Duo developer tech talks, linked in it. This independent project is not af

Code and original material are MIT licensed. The license does not claim to extend to material owned by Apple or others, including the guidelines the reference files are distilled from. See [LICENSE](https://github.com/justinwetch/HIGAgentSk

| Name | SwiftUI API | Default (light) | Default (dark) | Increased contrast (light) | Increased contrast (dark) | | --- | --- | --- | --- | --- | --- | | Red | [red](https://developer.apple.com/documentation/SwiftUI/Color/red) | [Image: R-

| --- | --- | --- | --- | --- | --- | | Red | [red](https://developer.apple.com/documentation/SwiftUI/Color/red) | [Image: R-255,G-56,B-60] | [Image: R-255,G-66,B-69] | [Image: R-233,G-21,B-45] | [Image: R-255,G-97,B-101] | | Orange | [oran

| Red | [red](https://developer.apple.com/documentation/SwiftUI/Color/red) | [Image: R-255,G-56,B-60] | [Image: R-255,G-66,B-69] | [Image: R-233,G-21,B-45] | [Image: R-255,G-97,B-101] |

| Orange | [orange](https://developer.apple.com/documentation/SwiftUI/Color/orange) | [Image: R-255,G-141,B-40] | [Image: R-255,G-146,B-48] | [Image: R-197,G-83,B-0] | [Image: R-255,G-160,B-86] |

| Yellow | [yellow](https://developer.apple.com/documentation/SwiftUI/Color/yellow) | [Image: R-255,G-204,B-0] | [Image: R-255,G-214,B-0] | [Image: R-161,G-106,B-0] | [Image: R-254,G-223,B-67] |

| Green | [green](https://developer.apple.com/documentation/SwiftUI/Color/green) | [Image: R-52,G-199,B-89] | [Image: R-48,G-209,B-88] | [Image: R-0,G-137,B-50] | [Image: R-74,G-217,B-104] |

| Mint | [mint](https://developer.apple.com/documentation/SwiftUI/Color/mint) | [Image: R-0,G-200,B-179] | [Image: R-0,G-218,B-195] | [Image: R-0,G-133,B-117] | [Image: R-84,G-223,B-203] |

| Teal | [teal](https://developer.apple.com/documentation/SwiftUI/Color/teal) | [Image: R-0,G-195,B-208] | [Image: R-0,G-210,B-224] | [Image: R-0,G-129,B-152] | [Image: R-59,G-221,B-236] |

| Cyan | [cyan](https://developer.apple.com/documentation/SwiftUI/Color/cyan) | [Image: R-0,G-192,B-232] | [Image: R-60,G-211,B-254] | [Image: R-0,G-126,B-174] | [Image: R-109,G-217,B-255] |

| Blue | [blue](https://developer.apple.com/documentation/SwiftUI/Color/blue) | [Image: R-0,G-136,B-255] | [Image: R-0,G-145,B-255] | [Image: R-30,G-110,B-244] | [Image: R-92,G-184,B-255] |

| Indigo | [indigo](https://developer.apple.com/documentation/SwiftUI/Color/indigo) | [Image: R-97,G-85,B-245] | [Image: R-109,G-124,B-255] | [Image: R-86,G-74,B-222] | [Image: R-167,G-170,B-255] |

| Purple | [purple](https://developer.apple.com/documentation/SwiftUI/Color/purple) | [Image: R-203,G-48,B-224] | [Image: R-219,G-52,B-242] | [Image: R-176,G-47,B-194] | [Image: R-234,G-141,B-255] |

| Pink | [pink](https://developer.apple.com/documentation/SwiftUI/Color/pink) | [Image: R-255,G-45,B-85] | [Image: R-255,G-55,B-95] | [Image: R-231,G-18,B-77] | [Image: R-255,G-138,B-196] |

| Brown | [brown](https://developer.apple.com/documentation/SwiftUI/Color/brown) | [Image: R-172,G-127,B-94] | [Image: R-183,G-138,B-102] | [Image: R-149,G-109,B-81] | [Image: R-219,G-166,B-121] |

| Name | UIKit API | Default (light) | Default (dark) | Increased contrast (light) | Increased contrast (dark) | | --- | --- | --- | --- | --- | --- | | Gray | [systemGray](https://developer.apple.com/documentation/UIKit/UIColor/systemGray)

| --- | --- | --- | --- | --- | --- | | Gray | [systemGray](https://developer.apple.com/documentation/UIKit/UIColor/systemGray) | [Image: R-142,G-142,B-147] | [Image: R-142,G-142,B-147] | [Image: R-108,G-108,B-112] | [Image: R-174,G-174,B-1

| Gray | [systemGray](https://developer.apple.com/documentation/UIKit/UIColor/systemGray) | [Image: R-142,G-142,B-147] | [Image: R-142,G-142,B-147] | [Image: R-108,G-108,B-112] | [Image: R-174,G-174,B-178] |

| Gray (2) | [systemGray2](https://developer.apple.com/documentation/UIKit/UIColor/systemGray2) | [Image: R-174,G-174,B-178] | [Image: R-99,G-99,B-102] | [Image: R-142,G-142,B-147] | [Image: R-124,G-124,B-128] |

| Gray (3) | [systemGray3](https://developer.apple.com/documentation/UIKit/UIColor/systemGray3) | [Image: R-199,G-199,B-204] | [Image: R-72,G-72,B-74] | [Image: R-174,G-174,B-178] | [Image: R-84,G-84,B-86] |

| Gray (4) | [systemGray4](https://developer.apple.com/documentation/UIKit/UIColor/systemGray4) | [Image: R-209,G-209,B-214] | [Image: R-58,G-58,B-60] | [Image: R-188,G-188,B-192] | [Image: R-68,G-68,B-70] |

| Gray (5) | [systemGray5](https://developer.apple.com/documentation/UIKit/UIColor/systemGray5) | [Image: R-229,G-229,B-234] | [Image: R-44,G-44,B-46] | [Image: R-216,G-216,B-220] | [Image: R-54,G-54,B-56] |

| Gray (6) | [systemGray6](https://developer.apple.com/documentation/UIKit/UIColor/systemGray6) | [Image: R-242,G-242,B-247] | [Image: R-28,G-28,B-30] | [Image: R-235,G-235,B-240] | [Image: R-36,G-36,B-38] |

In SwiftUI, the equivalent of `systemGray` is [gray](https://developer.apple.com/documentation/SwiftUI/Color/gray).

[Credential-related source omitted]

**Let the system localize and mirror your keyboard shortcuts as needed.** The system automatically localizes a shortcut’s primary and modifier keys to support the currently connected keyboard; if your app or game switches to a right-to-left

> **note:** > All scale factors in the table above are UIKit scale factors, which may differ from native scale factors. For developer guidance, see [scale](https://developer.apple.com/documentation/UIKit/UIScreen/scale) and [nativeScale](ht

> All scale factors in the table above are UIKit scale factors, which may differ from native scale factors. For developer guidance, see [scale](https://developer.apple.com/documentation/UIKit/UIScreen/scale) and [nativeScale](https://develo

A size class is a value that’s either regular or compact, where *regular* refers to a larger screen or a screen in landscape orientation and *compact* refers to a smaller screen or a screen in portrait orientation. For developer guidance, s

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

You can display emphasized variants of system text styles using symbolic traits. In SwiftUI, use the [bold()](https://developer.apple.com/documentation/SwiftUI/Text/bold()) modifier; in UIKit, use [traitBold](https://developer.apple.com/doc

- Existing skill contract: `SKILL.md` loads tier 1 foundations, platform files, trigger matches, one-hop related files, then on-demand niche files. - Existing distillation standard: about 75% compression while preserving measurements, API n

- Existing distillation standard: about 75% compression while preserving measurements, API names, platform differences, do/do-not directives, and specific behavioral rules. - Apple source root: `https://developer.apple.com/design/human-inte

- Apple source root: `https://developer.apple.com/design/human-interface-guidelines/`.

- Apple JSON root: `https://developer.apple.com/tutorials/data/design/human-interface-guidelines.json`.

- Apple JSON page pattern: `https://developer.apple.com/tutorials/data/design/human-interface-guidelines/{slug}.json`.

Apple Developer tech talks, retrieved 2026-09-24: - [T461] [Prepare your app for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111461/)

- [T461] [Prepare your app for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111461/)

- [T462] [Raise the bar with iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111462/)

- [T463] [Strike a pose with adaptive layouts on iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111463/)

- [T464] [Leverage multiple displays and scenes on iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111464/)

- [T465] [Build a great camera experience for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111465/)

- [T466] [Design for iPhone Duo](https://developer.apple.com/videos/play/tech-talks/111466/)

Audit with [Accessibility Inspector](https://developer.apple.com/documentation/accessibility/accessibility-inspector), which highlights issues and shows how the app represents itself to system accessibility features. [Accessibility Nutritio

If the interface conveys information through audio cues such as success, error, or game feedback, consider pairing them with matching haptics for people who cannot perceive audio or have it turned off. In iOS and iPadOS, [Music Haptics](htt

Label elements appropriately for [Voice Control](https://developer.apple.com/documentation/accessibility/voice-control). Integrate Siri and Shortcuts so important, repetitive tasks can be done by voice, including from Siri, the Action butto

Give people discoverable controls to start and stop audio/video, and consider a global opt-out for autoplay. Respond to **Dim Flashing Lights** during video playback. Be cautious with fast-moving and blinking effects: in excess they can dis

When [Assistive Access](https://developer.apple.com/documentation/accessibility/assistive-access) is on (iOS and iPadOS), identify core functionality and consider removing noncritical workflows and UI. Break up multistep workflows so people

Related: [Inclusion](https://developer.apple.com/design/human-interface-guidelines/inclusion), [Typography](https://developer.apple.com/design/human-interface-guidelines/typography), [VoiceOver](https://developer.apple.com/design/human-inte

Developer references: [Building accessible apps](https://developer.apple.com/accessibility/), [Accessibility framework](https://developer.apple.com/documentation/accessibility), and [Accessibility Nutrition Labels](https://developer.apple.c

Source: [Apple HIG — Accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility), captured 2026-09-12.

Source: [Action button](https://developer.apple.com/design/human-interface-guidelines/action-button), captured 2026-09-12.

Source: [Action sheets](https://developer.apple.com/design/human-interface-guidelines/action-sheets), captured 2026-09-12.

Source: [Activity rings](https://developer.apple.com/design/human-interface-guidelines/activity-rings), captured 2026-09-12.

Source: [Activity views](https://developer.apple.com/design/human-interface-guidelines/activity-views), captured 2026-09-12.

These rules cover the AirPlay icon shown with other technology icons, not the playback-control symbol. Download audio and video icons from [Apple Design Resources](https://developer.apple.com/design/resources/). Match other technology icons

Source: [AirPlay](https://developer.apple.com/design/human-interface-guidelines/airplay), captured 2026-09-12.

Source: [Alerts](https://developer.apple.com/design/human-interface-guidelines/alerts), captured 2026-09-12.

- **Hide sensitive information**, like bank balances or health data, including in [notifications](https://developer.apple.com/design/human-interface-guidelines/notifications).

Source: [Always On](https://developer.apple.com/design/human-interface-guidelines/always-on), captured 2026-09-12.

Source: [App Clips](https://developer.apple.com/design/human-interface-guidelines/app-clips), captured 2026-09-12.

Craft foreground layers in a design tool. For iOS/iPadOS/macOS/watchOS, import them into **Icon Composer** (in Xcode; also on the [Apple Developer website](https://developer.apple.com/icon-composer)) to define the background, place layers, 

- Make the background stand out and emphasize foreground content. Gradients must respond to system lighting; Icon Composer supports solid/gradient backgrounds, so imported images are usually unnecessary. An imported background must be full-

- Provide **unmasked** layers: square for iOS/iPadOS/macOS (the system's rounded corners match other rounded elements and the device bezel) and visionOS/watchOS, rectangular for tvOS (concentric rounded edges). Let the system mask edges; pr

- Keep core features consistent; don't swap elements between variants. Dark icons are subdued and clear/tinted more so, so preserve visibility, legibility, and recognition beside system icons/widgets. - Base dark on light with complementary

- Base dark on light with complementary colors and no excessive brightness; color backgrounds generally give greatest contrast. See [Dark Mode](https://developer.apple.com/design/Human-Interface-Guidelines/dark-mode).

- **Alternate icons:** iOS/iPadOS/tvOS and compatible visionOS apps may let people choose a related icon in settings (for example, a sports team). Keep alternates tied to the app and distinct from other apps. iOS/iPadOS alternates need dark

[Apple Design Resources](https://developer.apple.com/design/resources/) · [Icon Composer](https://developer.apple.com/icon-composer/) · [Icons](https://developer.apple.com/design/human-interface-guidelines/icons) · [Images](https://develope

Source: [Apple Human Interface Guidelines — App icons](https://developer.apple.com/design/Human-Interface-Guidelines/app-icons), captured 2026-09-12.

Source: [App Shortcuts](https://developer.apple.com/design/human-interface-guidelines/app-shortcuts), captured 2026-09-12.

- **Don't hide an Apple Pay button or make it appear unavailable**; if it can't be used yet (no size chosen), gracefully explain after it's tapped or clicked. - **Inform search engines**: list Apple Pay as a payment option in your website's

- Websites offering Apple Pay must include a privacy statement and follow the [Acceptable use guidelines for Apple Pay on the web](https://developer.apple.com/apple-pay/acceptable-use-guidelines-for-websites/).

For [approved nonprofits](https://developer.apple.com/support/apple-pay-nonprofits/).

- **Use only Apple's artwork, altering nothing but height**, which must equal or exceed other payment brand marks in the flow. Don't adjust width, corner radius or aspect ratio; add a trademark symbol or other content; remove the border; ad

- Get the mark and full usage rules from the [Apple Pay Marketing Guidelines](https://developer.apple.com/apple-pay/marketing/).

- **Use Apple Pay exactly as in the [Apple Trademark List](https://www.apple.com/legal/intellectual-property/trademark/appletmlist.html)**: two words, uppercase *A* and *P*, the rest lowercase, never plural or possessive; all caps only to c

- **Don't translate *Apple Pay* or any Apple trademark**; always use English, even in non-English text. - **In a payment selection context, use a text-only Apple Pay description only if all options are text-only.** If any has an icon or log

- **When promoting Apple Pay in an app, follow the [App Store marketing guidelines](https://developer.apple.com/app-store/marketing/guidelines/).**

Source: [Apple Pay](https://developer.apple.com/design/human-interface-guidelines/apple-pay), captured 2026-09-12.

Apple Pencil supports pixel-level drawing, handwriting, marking up, pointing, and UI interaction. Scribble uses fast, private, on-device handwriting recognition to enter text in text fields. See [Apple Pencil](https://www.apple.com/apple-pe

- Don’t use hover to initiate actions. The distance is imprecise, so accidental activation—especially destructive activation—is possible. - Prefer a preview value near the middle of a dynamic range such as opacity or flow. A maximum-pressur

- Prefer a preview value near the middle of a dynamic range such as opacity or flow. A maximum-pressure preview can occlude the mark area; a minimum-pressure preview may be hard to see or invisible. - Consider a contextual tool menu near th

- Consider a contextual tool menu near the marking location in response to hover plus a gesture such as [squeeze](https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble#Squeeze) or a keyboard modifier.

- Prefer hover previews for Apple Pencil over a pointing device when the same cue would be confusing. See [Adopting hover support for Apple Pencil](https://developer.apple.com/documentation/uikit/adopting-hover-support-for-apple-pencil).

Apple Pencil Pro squeeze can run a custom action, but people may configure it for an [App Shortcut](https://developer.apple.com/design/human-interface-guidelines/app-shortcuts). Squeeze is available only while the paired iPad screen is on a

Scribble is integrated into iPadOS and enabled for all apps by default. Let people write wherever text is naturally accepted without tapping or switching modes first. Standard text fields, text views, search fields, and editable web content

[PencilKit](https://developer.apple.com/documentation/pencilkit) captures touch and Apple Pencil input as a drawing, displays it in the app, and provides a low-latency custom drawing canvas with a tool picker and ink palette for notes, anno

[Entering data](https://developer.apple.com/design/human-interface-guidelines/entering-data) · [Undo and redo](https://developer.apple.com/design/human-interface-guidelines/undo-and-redo)

Source: [Apple Human Interface Guidelines — Apple Pencil and Scribble](https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble) (captured 2026-09-12).

Controls that launch ARKit-based experiences can show the AR glyph, and apps can badge items viewable in AR using ARKit; get both from [Apple Design Resources](https://developer.apple.com/design/resources/#ios-apps).

Source: [Augmented reality](https://developer.apple.com/design/human-interface-guidelines/augmented-reality), captured 2026-09-12.

**Platform:** visionOS has no additional considerations. By default, iOS and iPadOS use secondary and tertiary background [colors](https://developer.apple.com/design/human-interface-guidelines/color); macOS displays the title above by defau

**Resources:** [Layout](https://developer.apple.com/design/human-interface-guidelines/layout). [`GroupBox`](https://developer.apple.com/documentation/swiftui/groupbox) is a SwiftUI view with an optional label collecting a logical grouping; 

Source: [Apple HIG — Boxes](https://developer.apple.com/design/human-interface-guidelines/boxes), captured 2026-09-12.

Express a recognizable brand identity while feeling at home on the platform and giving people a consistent experience. Brand expression can appear in the app icon, throughout the experience, and in App Store presentation; see the [App Store

- Resist displaying the logo throughout the app or game unless it provides essential context; use the space for useful information and controls. - Avoid using a launch screen as a branding opportunity. It disappears too quickly to convey in

- Follow Apple’s trademark guidelines. Apple trademarks must not appear in an app name or images; consult the [Apple Trademark List](https://www.apple.com/legal/intellectual-property/trademark/appletmlist.html) and [Guidelines for Using App

Resources: [App Store Marketing Guidelines](https://developer.apple.com/app-store/marketing/guidelines/), [app previews](https://developer.apple.com/app-store/app-previews/), and [Color](https://developer.apple.com/design/human-interface-gu

Source: [Apple HIG — Branding](https://developer.apple.com/design/human-interface-guidelines/branding), captured 2026-09-12.

**Push buttons** (the standard type) show text, a symbol, icon, image, or text plus image; they can be tinted and be a view's default button. - Use a flexible-height push button ([`flexiblePush`](https://developer.apple.com/documentation/ap

- Use a flexible-height push button ([`flexiblePush`](https://developer.apple.com/documentation/appkit/nsbutton/bezelstyle-swift.enum/flexiblepush)) only for tall or variable-height content, such as two text lines or a tall icon. It keeps t

**Square (gradient) buttons** ([`smallSquare`](https://developer.apple.com/documentation/appkit/nsbutton/bezelstyle-swift.enum/smallsquare)) act on a view, like adding or removing table rows. Place them near the view, usually within or bene

**Image buttons** show an image, symbol or icon and can behave as push buttons, toggles or pop-up buttons. Leave about 10 px of padding between image and button edges, which define the clickable area. Generally avoid the system border ([`is

Developer: `Button` (SwiftUI), `UIButton`, `NSButton`. See also [Location button](https://developer.apple.com/design/human-interface-guidelines/privacy#Location-button).

Source: [Buttons](https://developer.apple.com/design/human-interface-guidelines/buttons), captured 2026-09-12.

- **Use SF Symbols for control functionality.** Custom symbols aren’t supported. Choose a symbol that clearly denotes behavior; control symbols don’t represent current state. For example, use `bolt.fill` for flash and `camera.filters` for f

- **Keep control names short.** Labels use Dynamic Type and longer names may obscure the viewfinder. - **Give slider values context with units or symbols** such as EV, %, or a custom string. [`AVCaptureSlider.localizedValueFormat`](https://

- **Give slider values context with units or symbols** such as EV, %, or a custom string. [`AVCaptureSlider.localizedValueFormat`](https://developer.apple.com/documentation/avfoundation/avcaptureslider/localizedvalueformat) is a `String?` t

- **Define prominent slider values** — frequently chosen or evenly spaced values such as major zoom increments — so sliding lands on them more easily. [`AVCaptureSlider.prominentValues`](https://developer.apple.com/documentation/avfoundatio

- **Enable or disable controls by camera mode** (for example, disable video controls while taking photos). The overlay supports multiple controls, but controls can’t be added or removed at runtime. - **Arrange controls by frequency.** Put c

- **Support launch from anywhere.** Create a locked camera capture extension so people can configure Camera Control to launch the camera experience from the locked device, Home Screen, or another app; see [Camera experiences on a locked dev

[SF Symbols](https://developer.apple.com/design/human-interface-guidelines/sf-symbols) · [Controls](https://developer.apple.com/design/human-interface-guidelines/controls) · [Enhancing your app experience with the Camera Control](https://de

Source: [Apple HIG — Camera Control](https://developer.apple.com/design/human-interface-guidelines/camera-control), captured 2026-09-12.

CareKit can incorporate ResearchKit surveys, tasks, and charts, plus its informed-consent module to request permission to collect and share data. See [HealthKit](https://developer.apple.com/design/Human-Interface-Guidelines/healthkit) and [

Most styles work best with CareKit’s built-in phone, message, envelope, and clock symbols. The grid task view can use custom UI; for unique groupings (such as a pill for medication or walking person for exercise), consider [SF Symbols](http

Resources: [Research & Care > CareKit](https://www.researchandcare.org/carekit/) · [CareKit](https://carekit-apple.github.io/CareKit/documentation/carekit) · [CareKit > Chart Interfaces](https://carekit-apple.github.io/CareKit/documentation

Source: [Apple Human Interface Guidelines — CareKit](https://developer.apple.com/design/Human-Interface-Guidelines/carekit), captured 2026-09-12.

Help drivers perform tasks quickly with minimal interaction, using the system-defined templates for your app type ([CarPlay App Programming Guide](https://developer.apple.com/carplay/documentation/CarPlay-App-Programming-Guide.pdf)); iOS re

- **Test colors in an actual car under varied lighting**, considering brightness at night and low-contrast washout in direct sunlight; adjust if necessary. - **Ensure your app looks great in dark and light environments**; CarPlay may switch

- **Choose colors that communicate effectively with everyone** ([Inclusive color](https://developer.apple.com/design/human-interface-guidelines/color#Inclusive-color)).

Source: [CarPlay](https://developer.apple.com/design/human-interface-guidelines/carplay), captured 2026-09-12.

Source: [Charting data](https://developer.apple.com/design/human-interface-guidelines/charting-data), captured 2026-09-12.

Source: [Charts](https://developer.apple.com/design/human-interface-guidelines/charts), captured 2026-09-12.

These features work with CloudKit, iCloud Drive, or custom infrastructure. A custom solution must also support universal links. SharePlay supports real-time activities from each person’s device; see [SharePlay](https://developer.apple.com/d

- Put the **Share button** somewhere convenient, such as a toolbar (the Notes example places it beside More). iOS 16’s share sheet lets people choose a file-sharing method and permissions for a new collaboration; iPadOS 16 and macOS 13 prov

- Add custom items to the collaboration popover only when needed. Its top section lists collaborators and communication buttons (Messages or FaceTime), the middle contains custom items, and the bottom has the shared-file management button. 

- Consider Messages collaboration event notifications for content or membership changes and participant mentions; include a universal link to the relevant app view via [`SWHighlightEvent`](https://developer.apple.com/documentation/sharedwit

In SwiftUI, use [`ShareLink`](https://developer.apple.com/documentation/swiftui/sharelink) to present the system share sheet.

- [Activity views](https://developer.apple.com/design/human-interface-guidelines/activity-views), [Shared with You](https://developer.apple.com/documentation/sharedwithyou), and [Supporting universal links in your app](https://developer.app

- [Design for Collaboration with Messages](https://developer.apple.com/videos/play/wwdc2022/10015), [Enhance collaboration experiences with Messages](https://developer.apple.com/videos/play/wwdc2022/10095), and [Integrate your custom collab

Source: [Collaboration and sharing](https://developer.apple.com/design/human-interface-guidelines/collaboration-and-sharing) (captured 2026-09-12).

- Related: [Lists and tables](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables), [Image views](https://developer.apple.com/design/human-interface-guidelines/image-views), [Layout](https://developer.apple.com/de

- [`UICollectionView`](https://developer.apple.com/documentation/uikit/uicollectionview) (UIKit); [`NSCollectionView`](https://developer.apple.com/documentation/appkit/nscollectionview) (AppKit).

Source: [Apple Human Interface Guidelines — Collections](https://developer.apple.com/design/human-interface-guidelines/collections) (captured 2026-09-12).

Related: [Color](https://developer.apple.com/design/human-interface-guidelines/color)

Developer documentation: [`UIColorWell`](https://developer.apple.com/documentation/uikit/uicolorwell) — UIKit; [`UIColorPickerViewController`](https://developer.apple.com/documentation/uikit/uicolorpickerviewcontroller) — UIKit; [`NSColorWe

Source: [Apple Human Interface Guidelines — Color wells](https://developer.apple.com/design/human-interface-guidelines/color-wells) (captured 2026-09-12).

Source: [Color](https://developer.apple.com/design/human-interface-guidelines/color), captured 2026-09-12.

A column view, or *browser*, navigates a data hierarchy through vertical columns: each column is one level of horizontal rows; a parent with children has a triangle, and selecting it opens its children in the next column. People can continu

- Related: [Lists and tables](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables), [Outline views](https://developer.apple.com/design/human-interface-guidelines/outline-views), [Split views](https://developer.app

- [`NSBrowser`](https://developer.apple.com/documentation/appkit/nsbrowser) (AppKit).

Source: [Apple Human Interface Guidelines — Column views](https://developer.apple.com/design/human-interface-guidelines/column-views) (captured 2026-09-12).

- Populate the field with a meaningful list default. It may be empty, but a value referring to a hidden choice is best and needn’t be first. - Use an introductory label for expected item types; generally use title-style capitalization and a

- Use an introductory label for expected item types; generally use title-style capitalization and a final colon. See [Labels](https://developer.apple.com/design/human-interface-guidelines/labels).

Related: [Text fields](https://developer.apple.com/design/human-interface-guidelines/text-fields) and [Pull-down buttons](https://developer.apple.com/design/human-interface-guidelines/pull-down-buttons). Supported in macOS; not supported in

Developer documentation: [`NSComboBox`](https://developer.apple.com/documentation/appkit/nscombobox), an AppKit view displaying a pop-up list for selecting or typing a custom value.

Source: [Apple HIG — Combo boxes](https://developer.apple.com/design/human-interface-guidelines/combo-boxes), captured 2026-09-12.

Source: [Complications](https://developer.apple.com/design/human-interface-guidelines/complications), captured 2026-09-12.

- Make every command available in the main interface too (Mail’s toolbar; macOS menu bar). If needed, use one submenu level with a predictive title. - Show only relevant items: hide unavailable ones instead of dimming them, except macOS may

- Put keyboard shortcuts in main menus. Use separators sparingly, generally no more than **about three groups**. In iOS/iPadOS/visionOS, put destructive commands last and mark them destructive for possible red text via [`UIMenuElement.Attri

Menus rarely need a title; each item needs a short, clear label. Add a title only when it clarifies the effect, such as the number of selected Mail messages affected by Mark. Use familiar system icons consistently for Copy, Share, Delete, a

In iOS/iPadOS, a menu can show a nearby preview. In some cases, people can tap the preview to open it or drag it elsewhere. Prefer a graphical preview that confirms the target (Notes/Mail can show a condensed list item). Match its clipping 

**macOS:** A context menu is also called a *contextual* menu. Use [`NSMenu.popUpContextMenu(_:with:for:)`](<https://developer.apple.com/documentation/appkit/nsmenu/popupcontextmenu(_:with:for:)>) to display one over a view for an event.

[`contextMenu(menuItems:)`](<https://developer.apple.com/documentation/swiftui/view/contextmenu(menuitems:)>) (source metadata: deprecated) adds a menu to a view; [`UIContextMenuInteraction`](https://developer.apple.com/documentation/uikit/

Source: [Controls](https://developer.apple.com/design/human-interface-guidelines/controls), captured 2026-09-12.

[Color](https://developer.apple.com/design/human-interface-guidelines/color), [Materials](https://developer.apple.com/design/human-interface-guidelines/materials), [Accessibility](https://developer.apple.com/design/human-interface-guideline

Source: [Apple Human Interface Guidelines — Dark Mode](https://developer.apple.com/design/human-interface-guidelines/dark-mode/), captured 2026-09-12.

Source: [Apple HIG — Design principles](https://developer.apple.com/design/human-interface-guidelines/design-principles), captured 2026-09-12.

Source: [Designing for games](https://developer.apple.com/design/human-interface-guidelines/designing-for-games), captured 2026-09-12.

Source: [Apple HIG — Designing for iOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-ios), captured 2026-09-12.

Source: [Apple HIG — Designing for iPadOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados), captured 2026-09-12.

Developer APIs: [SwiftUI safeAreaInsets](https://developer.apple.com/documentation/swiftui/geometryproxy/safeareainsets), [UIKit safeAreaInsets](https://developer.apple.com/documentation/uikit/uiview/safeareainsets), [NavigationSplitView](h

Source: [Apple HIG — Designing for iPhone Duo](https://developer.apple.com/design/human-interface-guidelines/designing-for-iphone-duo), new page dated September 9, 2026; captured 2026-09-12.

- **Display:** A Mac typically has a large, high-resolution display; additional displays, including an iPad, can extend the workspace. - **Ergonomics:** People generally use a Mac while stationary at a desk or table, typically viewing it fr

- **Ergonomics:** People generally use a Mac while stationary at a desk or table, typically viewing it from about 1–3 feet. - **Inputs:** Support combinations of physical [keyboards](https://developer.apple.com/design/human-interface-guidel

- **Inputs:** Support combinations of physical [keyboards](https://developer.apple.com/design/human-interface-guidelines/keyboards), [pointing devices](https://developer.apple.com/design/human-interface-guidelines/pointing-devices), [game c

- **System features:** Integrate with [the menu bar](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar), [file management](https://developer.apple.com/design/human-interface-guidelines/file-management), [full-screen

- [Apple Design Resources for macOS](https://developer.apple.com/design/resources/#macos-apps)

- [macOS pathway](https://developer.apple.com/macos/get-started/)

Source: [Apple HIG — Designing for macOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-macos), captured 2026-09-12.

- **Display:** A TV typically has a very large, high-resolution display. - **Ergonomics:** People generally remain many feet from a stationary TV—often 8 feet or more—but may interact while moving around the room. - **Inputs:** People can u

- **Ergonomics:** People generally remain many feet from a stationary TV—often 8 feet or more—but may interact while moving around the room. - **Inputs:** People can use remotes, game controllers, voice, and apps on other devices to interac

- **Inputs:** People can use remotes, game controllers, voice, and apps on other devices to interact with Apple TV. See the [Siri Remote](https://developer.apple.com/design/human-interface-guidelines/remotes), [game controllers](https://dev

- **System features:** Integrate with the [TV app](https://developer.apple.com/design/human-interface-guidelines/playing-video#Integrating-with-the-TV-app), [SharePlay](https://developer.apple.com/design/human-interface-guidelines/shareplay

- [Apple Design Resources for tvOS](https://developer.apple.com/design/resources/#tvos-apps)

- [tvOS pathway](https://developer.apple.com/tvos/get-started/)

- [Build SwiftUI apps for tvOS](https://developer.apple.com/videos/play/wwdc2020/10042)

Source: [Apple HIG — Designing for tvOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos), captured 2026-09-12.

Source: [Designing for visionOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos), captured 2026-09-12.

Source: [Designing for watchOS](https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos), captured 2026-09-12.

Resources: [Virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards), [`TVDigitEntryViewController`](https://developer.apple.com/documentation/tvuikit/tvdigitentryviewcontroller) — TVUIKit, a view 

Source: [Apple HIG — Digit entry views](https://developer.apple.com/design/human-interface-guidelines/digit-entry-views), captured 2026-09-12.

- Adjust volume. - Adjust immersion in a portal, an Environment, or an app/game running in Full Space; see [Immersive experiences](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences).

- Adjust immersion in a portal, an Environment, or an app/game running in Full Space; see [Immersive experiences](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences).

Not supported in iOS, iPadOS, macOS, or tvOS. Related: [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), [Action button](https://developer.apple.com/design/human-interface-guidelines/action-button), and [Im

Source: [Apple Human Interface Guidelines — Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown) (captured 2026-09-12).

macOS has no additional guidance. iOS, iPadOS, and visionOS provide disclosure controls through SwiftUI [`DisclosureGroup`](https://developer.apple.com/documentation/swiftui/disclosuregroup) (a view showing/hiding another content view by di

Related: [Outline views](https://developer.apple.com/design/human-interface-guidelines/outline-views), [Lists and tables](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables), [Buttons](https://developer.apple.com

AppKit: [`NSButton.BezelStyle.disclosure`](https://developer.apple.com/documentation/appkit/nsbutton/bezelstyle-swift.enum/disclosure) (bezel button for a disclosure triangle; Objective-C `NSBezelStyleDisclosure`); [`NSButton.BezelStyle.pus

Source: [Apple Human Interface Guidelines — Disclosure controls](https://developer.apple.com/design/human-interface-guidelines/disclosure-controls), captured 2026-09-12.

- Apply general [menu](https://developer.apple.com/design/human-interface-guidelines/menus) rules: succinct labels and logical organization.

Dock menus are unsupported in iOS, iPadOS, tvOS, visionOS, and watchOS. iOS/iPadOS instead provide similar system and custom actions through [Home Screen quick actions](https://developer.apple.com/design/human-interface-guidelines/home-scre

Developer documentation: on `NSApplicationDelegate`, Swift [`applicationDockMenu(_: NSApplication) -> NSMenu?`](<https://developer.apple.com/documentation/appkit/nsapplicationdelegate/applicationdockmenu(_:)>); Objective-C `applicationDockM

Source: [Apple HIG — Dock menus](https://developer.apple.com/design/human-interface-guidelines/dock-menus), captured 2026-09-12.

- **When possible, let people drag individual items from an inactive window without affecting its background selection.** - **Consider a count badge during multi-item drags** (small filled oval), updated if a destination accepts only some. 

- **Consider a count badge during multi-item drags** (small filled oval), updated if a destination accepts only some. - **Consider changing the pointer to indicate the drop result**: *copy*, *drag link*, *disappearing item*, *operation not 

- **Consider changing the pointer to indicate the drop result**: *copy*, *drag link*, *disappearing item*, *operation not allowed*. See [Pointers](https://developer.apple.com/design/human-interface-guidelines/pointing-devices#Pointers).

Source: [Drag and drop](https://developer.apple.com/design/human-interface-guidelines/drag-and-drop), captured 2026-09-12.

Context menu while editing, plus the menu bar's [Edit menu](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar#Edit-menu) (see it for item order).

Source: [Edit menus](https://developer.apple.com/design/human-interface-guidelines/edit-menus), captured 2026-09-12.

[Credential-related source omitted]

Source: [Entering data](https://developer.apple.com/design/human-interface-guidelines/entering-data), captured 2026-09-12.

Source: [Eyes](https://developer.apple.com/design/human-interface-guidelines/eyes), captured 2026-09-12.

- Make feedback accessible through multiple channels. Combining color, text, sound, and haptics reaches people who silence the device, look away, or use VoiceOver; see [Playing haptics](https://developer.apple.com/design/human-interface-gui

- Consider integrating status feedback near the item it describes (for example, Mail’s update status and unread count in the iOS/iPadOS mailbox toolbar). - Use [alerts](https://developer.apple.com/design/human-interface-guidelines/alerts) f

- Use [alerts](https://developer.apple.com/design/human-interface-guidelines/alerts) for critical, ideally actionable information, and match interruption to importance; overuse makes alerts lose impact. Warn before unexpected, irreversible 

Developer reference: [Animation and haptics](https://developer.apple.com/documentation/uikit/animation-and-haptics).

Source: [Apple HIG — Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), captured 2026-09-12.

Starting in iOS/iPadOS 18, a document app can use the full-screen document launcher via [DocumentGroupLaunchScene](https://developer.apple.com/documentation/swiftui/documentgrouplaunchscene), a SwiftUI launch scene for document-based apps. 

- Distinguish background from card/accessories with solid color, gradient, or pattern; complex imagery can distract. - Accessories may sit in front/behind for depth, but keep app name and both buttons visible. Avoid clutter; test supported 

- Use motion sparingly; prefer gentle repeating breathing/swaying ([Motion](https://developer.apple.com/design/human-interface-guidelines/motion)).

If files are shared, a File Provider extension can import/export/open/move documents. An app extension is installable code extending a specific system area; [FileProvider](https://developer.apple.com/documentation/fileprovider) exposes file

A Finder Sync extension expresses local/remote sync in Finder ([FinderSync](https://developer.apple.com/documentation/findersync)): status badges, contextual favorite/password-protect actions, and toolbar sync actions.

- Related: [Toolbars](https://developer.apple.com/design/human-interface-guidelines/toolbars), [File menu](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar#File-menu), [Printing](https://developer.apple.com/design/

- APIs: [SwiftUI Documents](https://developer.apple.com/documentation/swiftui/documents); [Build document-based apps in SwiftUI](https://developer.apple.com/videos/play/wwdc2020/10039).

Source: [File management](https://developer.apple.com/design/human-interface-guidelines/file-management) (captured 2026-09-12).

Supports the iPadOS and tvOS focus system through connected input devices like a keyboard or game controller. Looking at an object triggers the *hover effect* ([Eyes](https://developer.apple.com/design/human-interface-guidelines/eyes)), whi

Source: [Focus and selection](https://developer.apple.com/design/human-interface-guidelines/focus-and-selection), captured 2026-09-12.

Source: [Game Center](https://developer.apple.com/design/human-interface-guidelines/game-center), captured 2026-09-12.

You can use the [`TouchController`](https://developer.apple.com/documentation/touchcontroller) framework to add virtual controls to Metal-based games over game content, while allowing direct touch on game elements. Virtual controls generall

- If supporting controllers, try to provide a fallback for the platform default: touchscreen on iPhone/iPad, keyboard plus trackpad or mouse on Mac, remote on Apple TV, and eye/hand gestures on Apple Vision Pro. See [Adding virtual controls

- In tvOS and visionOS, a game may require a controller. The App Store then shows **Game Controller Required**; because the game can open without a connected controller, check presence and prompt gracefully. [`GCRequiresControllerUserIntera

- Detect pairing and obtain the controller profile automatically with the [`GameController`](https://developer.apple.com/documentation/gamecontroller) framework.

- The framework gives elements standard placement-based names, but real controllers can use different colors and symbols. Match the connected controller’s labeling scheme in onscreen content; [`GCControllerElement`](https://developer.apple.

Source: [Game controls](https://developer.apple.com/design/Human-Interface-Guidelines/game-controls) (captured 2026-09-12).

Source: [Gauges](https://developer.apple.com/design/human-interface-guidelines/gauges), captured 2026-09-12.

- Keep people in control: honor in-scope requests when output is clear, handle sensitive content carefully, let people dismiss/revert/retry, and identify where/when AI is used. Account for model bias/stereotypes: for people’s images/descrip

Tell people where AI is used; never make AI interaction/content appear human-authored; align disclosure with regional regulations. Set capability/limit expectations (for example, a brief tutorial, curated starter prompts for open-ended inpu

Evaluate model types hands-on early: some are general, others specialized. Availability can depend on device, network, and battery; [Foundation Models](https://developer.apple.com/documentation/foundationmodels) requires a compatible device

- Identify risks, make policies, and test accidental/purposeful misuse: out-of-scope, unrelated, poorly represented, vague, ambiguous, personal, sensitive, controversial, harmful, and incorrect requests. Use findings to improve the model, p

- Reduce copyright risk by building on models with protections, curating inputs, offering pre-approved prompts, and/or telling the model to avoid mimicking specified content or styles. - Design for latency. Non-generative [ARKit body-positi

- Design for latency. Non-generative [ARKit body-position tracking](https://developer.apple.com/documentation/arkit/capturing-body-motion-in-3d) and [Vision](https://developer.apple.com/documentation/vision) typically suit real time; genera

- Consider one result or multiple meaningfully different versions. Multiple choices can increase control and bridge the model’s interpretation with intent (Image Playground can generate multiple images); see [Multiple options](https://devel

Let people voluntarily report output feedback in a clear, noninterruptive location; resolve issues quickly. Consider quick positive/negative feedback controls, and you might also offer detailed feedback for complex problems. See [Explicit f

Resources: [Apple Intelligence and machine learning](https://developer.apple.com/documentation/technologyoverviews/ai-machine-learning), [Foundation Models](https://developer.apple.com/documentation/foundationmodels), [Core AI](https://deve

Source: [Apple Human Interface Guidelines — Generative AI](https://developer.apple.com/design/Human-Interface-Guidelines/generative-ai), captured 2026-09-12.

Custom gestures require a Full Space and hand-data permission ([ARKit data access](https://developer.apple.com/documentation/visionos/setting-up-access-to-arkit-data)).

Source: [Gestures](https://developer.apple.com/design/human-interface-guidelines/gestures), captured 2026-09-12.

Source: [Going full screen](https://developer.apple.com/design/human-interface-guidelines/going-full-screen), captured 2026-09-12.

On-device gyroscopes and accelerometers provide data about a device’s movement in the physical world. Use it for tangible, real-time motion experiences in iOS, iPadOS, and watchOS apps and games; tvOS apps can use Siri Remote gyroscope data

[Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback) · [Getting processed device-motion data](https://developer.apple.com/documentation/coremotion/getting-processed-device-motion-data) — Core Motion: retrieves 

Source: [Apple HIG — Gyroscope and accelerometer](https://developer.apple.com/design/human-interface-guidelines/gyro-and-accelerometer), captured 2026-09-12.

Use only the Apple-provided icon from [Apple Design Resources](https://developer.apple.com/design/resources/#technologies). Place *Apple Health* near it and, in a view containing other app icons, size it at least as large as the others. It 

Resources: [Works with Apple Health](https://developer.apple.com/health-fitness/works-with-apple-health/) · [Apple Design Resources](https://developer.apple.com/design/resources/#technologies) · [App Information > App Store Connect Help](ht

Source: [Apple Human Interface Guidelines — HealthKit](https://developer.apple.com/design/Human-Interface-Guidelines/healthkit), captured 2026-09-12.

Developer: UIKit, [Add Home Screen quick actions](https://developer.apple.com/documentation/uikit/add-home-screen-quick-actions).

Source: [Home Screen quick actions](https://developer.apple.com/design/human-interface-guidelines/home-screen-quick-actions), captured 2026-09-12.

HomeKit lets people securely control connected home accessories with Siri or the Home app on iPhone, iPad, Apple Watch and Mac; in iOS, the Home app also manages and configures them. iOS, tvOS and watchOS apps can integrate with it. MFi lic

Use the HomeKit icon in HomeKit setup or instructional communications. You can use the Apple Home app icon to reference the app or in a button opening its App Store [product page](https://itunes.apple.com/us/app/home/id1110145103?mt=8).

- **Use only [Apple-provided icons](https://developer.apple.com/design/resources/)**; don't create or mimic HomeKit or Home app icons.

- **Emphasize your app over HomeKit**: make HomeKit or Apple Home references less prominent than your app name or identity. - **Adhere to Apple's trademark guidelines.** Apple trademarks can't appear in your app name or images. In text, use

- **Adhere to Apple's trademark guidelines.** Apple trademarks can't appear in your app name or images. In text, use Apple product names exactly as on the [Apple Trademark List](https://www.apple.com/legal/intellectual-property/trademark/ap

Source: [HomeKit](https://developer.apple.com/design/human-interface-guidelines/homekit), captured 2026-09-12.

Source: [iCloud](https://developer.apple.com/design/human-interface-guidelines/icloud), captured 2026-09-12.

[SF Symbols](https://developer.apple.com/design/human-interface-guidelines/sf-symbols), [App icons](https://developer.apple.com/design/human-interface-guidelines/app-icons), [Inclusion](https://developer.apple.com/design/human-interface-gui

Source: [Apple Human Interface Guidelines — Icons](https://developer.apple.com/design/human-interface-guidelines/icons/)

- **Display Only** (`MobileDriversLicenseDisplayRequest`): system UI on the requester's iPhone shows data like name or age with the portrait for visual confirmation; the customer's data isn't sent to your app. - **Data Transfer** (`MobileDr

- **Data Transfer** (`MobileDriversLicenseDataRequest`, `MobileDriversLicenseRawDataRequest`): use only when you have a legal verification requirement and need to store or process data like address or birth date. Requires an additional [ent

- **Ask only for the data the current verification needs.** For a minimum age, request an age threshold (`ageAtLeast(_:)`); avoid requesting current age or birth date. - **If your app qualifies for [Apple Business Register](https://register

- **If your app qualifies for [Apple Business Register](https://register.apple.com/services/login?returnTo=/signin/tap-to-present-id-on-iphone), register for ID Verifier** so customers' devices show your official organization name and logo.

Source: [ID Verifier](https://developer.apple.com/design/human-interface-guidelines/id-verifier), captured 2026-09-12.

Many tvOS images combine transparent layers for depth; see [Layered images](https://developer.apple.com/design/human-interface-guidelines/images#Layered-images).

Source: [Image views](https://developer.apple.com/design/human-interface-guidelines/image-views), captured 2026-09-12.

Resources: [Image views](https://developer.apple.com/design/human-interface-guidelines/image-views), [Edit menu](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar#Edit-menu), [`NSImageView`](https://developer.apple.

Source: [Apple HIG — Image wells](https://developer.apple.com/design/human-interface-guidelines/image-wells), captured 2026-09-12.

- **Provide high-resolution assets for all bitmap images, for every device you support**, suffixing asset catalog filenames @1x, @2x or @3x. Guidance values ([more](https://developer.apple.com/design/human-interface-guidelines/layout)):

- **Include a [color profile](https://developer.apple.com/design/human-interface-guidelines/color#Color-management) with each image.**

- **Your app icon must be layered.** For other focusable images, including Top Shelf, layers are strongly encouraged but optional. - You can embed layered images or fetch them at runtime ([guide](https://help.apple.com/itc/parallaxpreviewer

- You can embed layered images or fetch them at runtime ([guide](https://help.apple.com/itc/parallaxpreviewer/)). Fetched ones must be runtime layered images (`.lcr`), built from LSR or Photoshop files with Xcode's `layerutil`; don't embed 

- **Keep the background layer opaque**, or you get an error. Higher layers can vary opacity. - **Keep layering simple and subtle**; excessive 3D effects can look jarring. - **Leave a safe zone around foreground layers** for essential conten

- **Keep layering simple and subtle**; excessive 3D effects can look jarring. - **Leave a safe zone around foreground layers** for essential content; focus scaling and movement may crop layers (see [App icons](https://developer.apple.com/de

- **Leave a safe zone around foreground layers** for essential content; focus scaling and movement may crop layers (see [App icons](https://developer.apple.com/design/human-interface-guidelines/app-icons)).

- **Always preview layered images** in Xcode, [Parallax Previewer or Exporter](https://developer.apple.com/design/resources/#parallax-previewer) while designing, readjusting as scaling and clipping occur, and on an actual TV when final.

- **Create a layered app icon**: two to three layers that move at subtly different rates in focus (see [App icons](https://developer.apple.com/design/human-interface-guidelines/app-icons#Layer-design)).

- **Prefer vector art for 2D images.** Avoid bitmaps; they might look poor scaled up. See [sharp Core Animation layers](https://developer.apple.com/documentation/visionOS/drawing-sharp-layer-based-content).

- **Make sure spatial photos render correctly: use stereo HEIC.** With spatial metadata, visionOS recognizes it as spatial and applies treatments that help minimize stereo-viewing discomfort. - **Prefer the feathered glass background effect

- **Prefer the feathered glass background effect (`GlassBackgroundEffect`) for text over spatial photos.** - **Consider visual comfort when making spatial photos from 2D content**; metadata like [disparity adjustment](https://developer.appl

- **Consider visual comfort when making spatial photos from 2D content**; metadata like [disparity adjustment](https://developer.apple.com/documentation/ImageIO/Creating-spatial-photos-and-videos-with-spatial-metadata) can cause discomfort 

Source: [Images](https://developer.apple.com/design/human-interface-guidelines/images), captured 2026-09-12.

Source: [iMessage apps and stickers](https://developer.apple.com/design/human-interface-guidelines/imessage-apps-and-stickers), captured 2026-09-12.

Passthrough is real-time video from external cameras that keeps people connected to their surroundings. The [Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown) can adjust passthrough, press-and-hold 

In a Full Space, other apps are hidden, but you can still show standard windows, volumes, and unbounded 3D content. See [`ImmersionStyle.automatic`](https://developer.apple.com/documentation/swiftui/immersionstyle/automatic) for the default

- **Dimmed passthrough:** In Shared Space, subtly dim or tint passthrough and visible content to focus attention without hiding other apps; in Full Space, it creates a more focused experience. Passthrough is tinted black by default; use [`S

- **`mixed`:** In a Full Space, blend unbounded 3D content with passthrough. With permission, [ARKit](https://developer.apple.com/documentation/arkit) can provide nearby-object and room-layout information. There is no boundary; nearby virtu

- **`progressive`:** In a Full Space, partially replace passthrough with a custom environment. Content can be displayed in portrait or landscape orientation; you can optionally set the immersion range, and the Digital Crown adjusts immersio

- **`full`:** In a Full Space, display a 360° custom environment that completely replaces passthrough. The approximately 1.5-meter boundary also applies. See [`ImmersionStyle.full`](https://developer.apple.com/documentation/swiftui/immersio

- Offer multiple ways to use the app or game and support the [accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility) features people use to personalize interaction.

- Prefer launching in Shared Space or `mixed`. Shared Space lets people reference and switch to other running software; either a Shared Space window or a `mixed` launch lets people choose when to increase immersion when the app also offers 

- Reserve immersion for meaningful moments. Many tasks benefit from staying grounded and using other software; for example, Photos can browse albums in a Shared Space window and open one photo more immersively in a Full Space. - Use subtle 

- Use subtle cues—dimming, tinting, [motion](https://developer.apple.com/design/human-interface-guidelines/motion), [scale](https://developer.apple.com/design/human-interface-guidelines/spatial-layout#Scale), and [Spatial Audio](https://dev

- In visionOS 2 and later, prefer subtle passthrough tints that coordinate surroundings and hands with the content; bright or dramatic tints distract and reduce immersion. - Prefer placing 3D content within the [field of view](https://devel

- Prefer placing 3D content within the [field of view](https://developer.apple.com/design/human-interface-guidelines/spatial-layout#Field-of-view) and display motion comfortably. Choose a style suited to expected movement: minor shifts, tur

- Use ARKit to blend content with surroundings or use hand positions; request permission for sensitive data. See [Privacy](https://developer.apple.com/design/human-interface-guidelines/privacy) and [`SceneReconstructionProvider`](https://de

- Make immersion changes smooth and predictable so people can track them; avoid sudden transitions. See [`CoordinateSpaceProtocol`](https://developer.apple.com/documentation/swiftui/coordinatespaceprotocol) for developer guidance. Use a cle

- When a Full Space app asks permission to replace real hands with virtual hands, **prefer** familiar hand positions and gestures. **Use caution** with oversized hands: they can obscure content, feel clumsy, or seem too close to the face. I

- Use [Spatial Audio](https://developer.apple.com/design/human-interface-guidelines/playing-audio) for location-based atmosphere, avoid repetitive loops, and lower or stop the soundscape when other audio plays. Generally prefer lit object m

- [Creating fully immersive experiences in your app](https://developer.apple.com/documentation/visionos/creating-fully-immersive-experiences); [Incorporating real-world surroundings in an immersive experience](https://developer.apple.com/do

- [Spatial layout](https://developer.apple.com/design/human-interface-guidelines/spatial-layout); [Motion](https://developer.apple.com/design/human-interface-guidelines/motion)

- [Design immersive environments for visionOS apps and the spatial web](https://developer.apple.com/videos/play/wwdc2026/234); [Principles of spatial design](https://developer.apple.com/videos/play/wwdc2023/10072); [Design spatial SharePlay

Source: [Apple HIG — Immersive experiences](https://developer.apple.com/design/human-interface-guidelines/immersive-experiences), captured 2026-09-12.

In-App Purchase lets people securely buy virtual goods in an app: premium content/features, digital items, and subscriptions. Use [Apple Pay](https://developer.apple.com/design/Human-Interface-Guidelines/apple-pay) for physical goods, real-

Let people experience the app before asking for payment; consider limited free access for subscriptions. Keep browsing, product presentation, and transactions integrated with the app’s visual style. Use short, plain names and descriptions t

You can promote and offer In-App Purchases directly through the App Store. For exceptionally large, frequently updated catalogs of one-time purchases or subscription content from multiple creators, or subscriptions with optional add-ons sol

Family Sharing can share eligible purchased content, including auto-renewable subscriptions and non-consumable purchases, with up to five additional family members across the purchaser’s Apple devices. Call out sharing where people learn ab

Offer a purchase-help screen before the refund flow. It can address missing purchases, FAQs, feedback, and direct support, while linking to the system refund flow. Label the action simply (“Refund” or “Request a Refund”); people request the

Do not characterize or predict Apple’s refund policy. Link to [Request a refund for apps or content that you bought from Apple](https://support.apple.com/en-us/HT204084) for process information.

Supply an engaging, informative promotional image when useful; without one, redemption screens use the app icon. After redemption, align the app with the new status: consider a welcome experience for new subscribers and, for an existing sub

Provide a subscription summary, especially the upcoming renewal date. Consider placing it near subscription management in settings or an account screen. [`Product.SubscriptionInfo`](https://developer.apple.com/documentation/storekit/product

[In-App Purchase](https://developer.apple.com/in-app-purchase/) · [Offering Subscriptions](https://developer.apple.com/app-store/subscriptions/) · [App Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) · [StoreKit

Source: [Apple Human Interface Guidelines — In-App Purchase](https://developer.apple.com/design/Human-Interface-Guidelines/in-app-purchase), captured 2026-09-12.

Resources: [Writing inclusively](https://help.apple.com/applestyleguide/#/apdcb2a65d68), [Accessibility](https://developer.apple.com/design/human-interface-guidelines/accessibility), and [Xcode localization](https://developer.apple.com/docu

Source: [Apple HIG — Inclusion](https://developer.apple.com/design/human-interface-guidelines/inclusion), captured 2026-09-12.

- **Support Full Keyboard Access when possible** (iOS, iPadOS, macOS, visionOS): keyboard-only navigation and activation of windows, menus, controls, system features. Test via Settings > Accessibility. `isFullKeyboardAccessEnabled`. - iPadO

- **Respect standard keyboard shortcuts.** For a frequent unique action, prefer a custom shortcut to repurposing a standard. Games: people may expect standards (Command-Q quits) and remappable key bindings ([Game controls](https://developer

Source: [Keyboards](https://developer.apple.com/design/human-interface-guidelines/keyboards), captured 2026-09-12.

A label is a static piece of text that people can read and often copy, but not edit. It appears in buttons, menu items, and views to explain context and actions: a button label generally names the action (Edit, Cancel, Send); a list label d

- **Use labels for small text people don’t need to edit.** Use a [text field](https://developer.apple.com/design/human-interface-guidelines/text-fields) for small editable text; use a [text view](https://developer.apple.com/design/human-int

| System color | Example usage | iOS, iPadOS, tvOS, visionOS | macOS |   | --- | --- | --- | --- |   | Label | Primary information | [`UIColor.label`](https://developer.apple.com/documentation/uikit/uicolor/label) | [`NSColor.labelColor`](h

| --- | --- | --- | --- |   | Label | Primary information | [`UIColor.label`](https://developer.apple.com/documentation/uikit/uicolor/label) | [`NSColor.labelColor`](https://developer.apple.com/documentation/appkit/nscolor/labelcolor) |   |

| Label | Primary information | [`UIColor.label`](https://developer.apple.com/documentation/uikit/uicolor/label) | [`NSColor.labelColor`](https://developer.apple.com/documentation/appkit/nscolor/labelcolor) |

| Secondary label | Subheading or supplemental text | [`UIColor.secondaryLabel`](https://developer.apple.com/documentation/uikit/uicolor/secondarylabel) | [`NSColor.secondaryLabelColor`](https://developer.apple.com/documentation/appkit/nsco

| Tertiary label | Text describing an unavailable item or behavior | [`UIColor.tertiaryLabel`](https://developer.apple.com/documentation/uikit/uicolor/tertiarylabel) | [`NSColor.tertiaryLabelColor`](https://developer.apple.com/documentation

| Quaternary label | Watermark text | [`UIColor.quaternaryLabel`](https://developer.apple.com/documentation/uikit/uicolor/quaternarylabel) | [`NSColor.quaternaryLabelColor`](https://developer.apple.com/documentation/appkit/nscolor/quaternar

For uneditable text, use [`NSTextField.isEditable`](https://developer.apple.com/documentation/appkit/nstextfield/iseditable) (`Bool`) on [`NSTextField`](https://developer.apple.com/documentation/appkit/nstextfield).

System date/timer components automatically fit the available space and update without app input. Consider them in complications; see [Complications](https://developer.apple.com/design/human-interface-guidelines/components/system-experiences

- Related: [Color](https://developer.apple.com/design/human-interface-guidelines/color).

- Developer documentation: [`UILabel`](https://developer.apple.com/documentation/uikit/uilabel) — UIKit view displaying one or more lines of informational text.

Source: [Apple HIG — Labels](https://developer.apple.com/design/human-interface-guidelines/labels), captured 2026-09-12.

**Resources:** [Onboarding](https://developer.apple.com/design/human-interface-guidelines/onboarding), [Loading](https://developer.apple.com/design/human-interface-guidelines/loading). Xcode’s [Specifying your app’s launch screen](https://d

Source: [Apple HIG — Launching](https://developer.apple.com/design/human-interface-guidelines/launching), captured 2026-09-12.

- Use progressive disclosure to reduce initial choices/content: disclosure triangles, menus, nested views; scrollable sections can reveal more media. - Where supported, Liquid Glass distinguishes controls from content. Prefer scroll-edge ef

- Where supported, Liquid Glass distinguishes controls from content. Prefer scroll-edge effects to solid/semi-opaque backgrounds beneath controls. Extend full-screen backgrounds beneath sidebars, toolbars, and tab bars to window/screen edge

- If edge-filling artwork would hide important parts behind a sidebar/inspector, a background extension can mirror, flip, and blur the image beneath adjacent components: [`backgroundExtensionEffect()`](<https://developer.apple.com/documenta

- Adapt to display/window sizes, compact/regular size classes, orientation/aspect ratio, Dynamic Island, external displays, Display Zoom, resizable iPad/Mac windows, text size, and locale (direction, formatting, font variation, text length)

- Respect system safe areas, margins, and guides; use layout modifiers to refine placement. Preserve familiarity when rotating, resizing, adding a display, or changing devices; orientation-locked apps/games must still resize well. - Accommo

- Accommodate Dynamic Type: horizontal views may stack; rows/containers may grow to avoid clipping/overlap and allow multiple lines. Unity games can use [Apple’s accessibility plug-in](https://github.com/apple/unityplugins/blob/main/plug-in

- Preview different devices, size classes, localizations, and text sizes; start with largest/smallest layouts. Use Xcode [Device Hub](https://developer.apple.com/documentation/xcode/device-hub) simulations to check clipping/resizing, includ

- If context changes crop, letterbox, or pillarbox background artwork, scale it to fill the screen **without changing the artwork’s aspect ratio**. Extreme window proportions may require artwork beyond the ordinarily visible area. - In iOS/

- In iOS/iPadOS, horizontal compact/regular describes narrow/wide; vertical compact/regular describes short/tall. Device, window, and multitasking state determine classes (full screen, Slide Over, iPhone Mirroring); every combination can oc

- **Choose layout from size classes, not device type/idiom or orientation:** those do not establish actual available space. Consider all combinations in either aspect ratio. APIs: [`UITraitChangeObservable`](https://developer.apple.com/docu

- A layout guide is a rectangle for positioning, alignment, and spacing. Predefined guides supply standard margins and readable text widths; custom guides are possible. [`UILayoutGuide`](https://developer.apple.com/documentation/uikit/uilay

- A safe area excludes edge-obstructing hardware or views (toolbar/tab/status bars, Dynamic Island). Respect it so system UI and hardware do not cover controls/content. [`SafeAreaRegions`](https://developer.apple.com/documentation/swiftui/s

**macOS:** Avoid controls/critical information at the window bottom (the window may be moved below the screen edge) and content behind the top-edge camera housing. See [`NSPrefersDisplaySafeAreaCompatibilityMode`](https://developer.apple.co

**tvOS:** Inset primary content **60 pt top/bottom and 80 pt sides** for overscan/compatibility. Focus enlarges UIKit elements, so pad them and prevent overlap. Space unfocused grid rows/columns accordingly; [`UICollectionViewFlowLayout`](h

**visionOS:** Content may be in a window, bounded 3D volume, or immersive space; this guidance covers windows/volumes (see [Spatial layout](https://developer.apple.com/design/human-interface-guidelines/spatial-layout)). In general, support 

**watchOS:** Usually show no more than three glyph buttons or two text buttons in a row. Full-width text buttons are preferred; two short-labeled side-by-side buttons can work if the screen does not scroll. Support autorotation for views pe

Source: [Apple HIG — Layout](https://developer.apple.com/design/human-interface-guidelines/layout), captured 2026-09-12.

Source: [Lists and tables](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables), captured 2026-09-12.

Source: [Live Activities](https://developer.apple.com/design/human-interface-guidelines/live-activities), captured 2026-09-12.

- [`PHLivePhoto`](https://developer.apple.com/documentation/photos/phlivephoto) — PhotoKit

- [`LivePhotosKit JS`](https://developer.apple.com/documentation/livephotoskitjs) — web playback

- [*What’s new in camera capture*](https://developer.apple.com/videos/play/wwdc2021/10047)

Source: [Live Photos](https://developer.apple.com/design/human-interface-guidelines/live-photos) (captured 2026-09-12).

- [Playing video](https://developer.apple.com/design/human-interface-guidelines/playing-video) and [Remotes](https://developer.apple.com/design/human-interface-guidelines/remotes)

Source: [Live-viewing apps](https://developer.apple.com/design/human-interface-guidelines/live-viewing-apps) (captured 2026-09-12).

- **Keep it usable while loading:** load in the background so people can act elsewhere (a game loads the next level while players read about it or open a menu). - **For unavoidable long waits,** show hints, tips, or feature introductions; e

- **Move large downloads to nondisruptive times:** consider [Background Assets](https://developer.apple.com/documentation/backgroundassets) for level packs, 3D models, textures, and similar assets immediately after installation, during upda

**Progress:** Communicate loading and duration. Show content instantly when possible; for waits beyond a moment or two, you can use system [progress indicators](https://developer.apple.com/design/human-interface-guidelines/progress-indicato

Source: [Apple HIG — Loading](https://developer.apple.com/design/human-interface-guidelines/loading), captured 2026-09-12.

- [`TVLockupView`](https://developer.apple.com/documentation/tvuikit/tvlockupview) is a focusable view for main content (such as a movie poster) with optional header and footer; [`TVLockupHeaderFooterView`](https://developer.apple.com/docum

- [`TVCardView`](https://developer.apple.com/documentation/tvuikit/tvcardview) applies a focus motion effect to its subviews; [`TVCaptionButtonView`](https://developer.apple.com/documentation/tvuikit/tvcaptionbuttonview) is a button-like in

Source: [Lockups](https://developer.apple.com/design/human-interface-guidelines/lockups), captured 2026-09-12.

Source: [Mac Catalyst](https://developer.apple.com/design/human-interface-guidelines/mac-catalyst), captured 2026-09-12.

Machine learning lets apps and games learn from data and usage patterns. Models can provide familiar capabilities such as image recognition and recommendations, or more individualized feeds, itineraries, and search suggestions. Design the m

- [Generative AI](https://developer.apple.com/design/human-interface-guidelines/generative-ai)

- [Privacy](https://developer.apple.com/design/human-interface-guidelines/privacy)

- [Apple Intelligence and machine learning](https://developer.apple.com/documentation/technologyoverviews/ai-machine-learning)

- [Create ML](https://developer.apple.com/documentation/createml)

- [Core ML](https://developer.apple.com/documentation/coreml)

- [Explore prompt design & safety for on-device foundation models](https://developer.apple.com/videos/play/wwdc2025/248)

- [Discover machine learning & AI frameworks on Apple platforms](https://developer.apple.com/videos/play/wwdc2025/360)

Source: [Apple Human Interface Guidelines — Machine learning](https://developer.apple.com/design/Human-Interface-Guidelines/machine-learning), captured 2026-09-12.

[Credential-related source omitted]

Source: [Managing accounts](https://developer.apple.com/design/human-interface-guidelines/managing-accounts), captured 2026-09-12.

You can present a place card when someone selects one of your places (`mapItemDetailSelectionAccessory(_:)`, `mapView(_:selectionAccessoryFor:)`, `selectionAccessory`) or another place, like a point of interest, territory or physical featur

- **Consider supporting navigation between your venue and nearby transit points** like bus stops, stations and parking. You might offer a quick switch to Apple Maps. - **Limit scrolling outside of your venue.** When possible, keep part of t

- **Design an indoor map that feels like a natural extension of your app.** Don't try to replicate Apple Maps; match overlays, icons and text to your app's style ([IMDF](https://register.apple.com/resources/imdf/)).

Source: [Maps](https://developer.apple.com/design/human-interface-guidelines/maps), captured 2026-09-12.

- Use Liquid Glass for controls and navigation (such as tab bars and sidebars) floating above content. Let content scroll and peek through while preserving control and navigation legibility. - **Don’t use Liquid Glass in the content layer.*

- **Don’t use Liquid Glass in the content layer.** Use standard materials for content-layer elements such as app backgrounds. The exception is a transient interactive control in that layer, such as a slider or toggle, which can take on Liqu

- Use Liquid Glass effects sparingly on custom controls; system components provide the appearance and behavior automatically. Limit custom effects to the most important functional elements because the material should draw attention to under

- Liquid Glass has [regular](https://developer.apple.com/documentation/swiftui/glass/regular) and [clear](https://developer.apple.com/documentation/swiftui/glass/clear) variants, whose appearance can change with preferred-look, reduced-tran

Use [blur](https://developer.apple.com/documentation/uikit/uiblureffect), [vibrancy](https://developer.apple.com/documentation/uikit/uivibrancyeffect), and AppKit [blending modes](https://developer.apple.com/documentation/appkit/nsvisualeff

**iOS, iPadOS:** Four standard content-layer materials are available: ultra-thin, thin, regular (default), and thick. Vibrancy defines label, fill, and separator hierarchy: default has highest contrast; quaternary, when available, lowest. L

**macOS:** Standard materials have designated purposes and all system colors have vibrant versions. Test custom views and controls across contexts and system settings before allowing vibrancy. Choose between [behind-window and within-window

| Material | Recommended for | |---|---| | [ultraThin](https://developer.apple.com/documentation/swiftui/material/ultrathin) | Full-screen views requiring a light color scheme |

|---|---| | [ultraThin](https://developer.apple.com/documentation/swiftui/material/ultrathin) | Full-screen views requiring a light color scheme | | [thin](https://developer.apple.com/documentation/swiftui/material/thin) | Partial overlays 

| [ultraThin](https://developer.apple.com/documentation/swiftui/material/ultrathin) | Full-screen views requiring a light color scheme |

| [thin](https://developer.apple.com/documentation/swiftui/material/thin) | Partial overlays requiring a light color scheme |

| [regular](https://developer.apple.com/documentation/swiftui/material/regular) | Partial overlays |

| [thick](https://developer.apple.com/documentation/swiftui/material/thick) | Partial overlays requiring a dark color scheme |

**visionOS:** Windows generally use unmodifiable adaptive *glass*, which lets light, the current Environment, virtual content, and surroundings show through while constraining background color for contrast. There is no distinct Dark Mode; g

**watchOS:** Use material layers for context in full-screen modal views; don’t remove or replace default modal-sheet materials. Developer references include [Adopting Liquid Glass](https://developer.apple.com/documentation/technologyovervie

Source: [Apple HIG — Materials](https://developer.apple.com/design/human-interface-guidelines/materials), captured 2026-09-12.

- **Represent common actions consistently** with [standard icons](https://developer.apple.com/design/human-interface-guidelines/icons#Standard-icons) like Share, Print and Search.

Source: [Menus](https://developer.apple.com/design/human-interface-guidelines/menus), captured 2026-09-12.

Modality presents content in a dedicated mode that blocks the parent view until explicit dismissal. Use it for critical information, confirming/modifying a recent action, a narrowly scoped task, or focus on immersive/complex work. All platf

Related: [Sheets](https://developer.apple.com/design/human-interface-guidelines/sheets), [Alerts](https://developer.apple.com/design/human-interface-guidelines/alerts), [Popovers](https://developer.apple.com/design/human-interface-guideline

Source: [Apple HIG — Modality](https://developer.apple.com/design/human-interface-guidelines/modality), captured 2026-09-12.

- Add motion purposefully; gratuitous or excessive animation distracts and can cause physical discomfort. Make motion optional: never make it the only way to communicate important information; supplement it with haptics and audio. - In nong

- In nongame apps, make feedback realistic and consistent with gestures and expectations. Keep feedback animations brief and precise. In apps, generally avoid animation on frequently repeated custom interactions. As much as possible, let pe

**watchOS:** SwiftUI provides a streamlined way to add motion. If you need WatchKit for layout/appearance animation or animated image sequences, see [WKInterfaceImage](https://developer.apple.com/documentation/watchkit/wkinterfaceimage). La

See [Animating views and transitions](https://developer.apple.com/tutorials/swiftui/animating-views-and-transitions).

Source: [Apple HIG — Motion](https://developer.apple.com/design/human-interface-guidelines/motion), captured 2026-09-12.

Developer links: [Responding to the launch of your app](https://developer.apple.com/documentation/uikit/responding-to-the-launch-of-your-app) and [Multitasking on iPad, Mac, and Apple Vision Pro](https://developer.apple.com/documentation/ui

Source: [Apple HIG — Multitasking](https://developer.apple.com/design/human-interface-guidelines/multitasking), captured 2026-09-12.

Nearby interactions use the physical presence of people and objects to create on-device experiences. They are available on devices supporting Ultra Wideband (see [Ultra Wideband availability](https://support.apple.com/en-us/HT212274)) and u

Source: [Apple Human Interface Guidelines — Nearby interactions](https://developer.apple.com/design/Human-Interface-Guidelines/nearby-interactions), captured 2026-09-12.

Source: [Apple Human Interface Guidelines — NFC](https://developer.apple.com/design/Human-Interface-Guidelines/nfc), captured 2026-09-12.

Source: [Notifications](https://developer.apple.com/design/human-interface-guidelines/notifications), [Managing notifications](https://developer.apple.com/design/human-interface-guidelines/managing-notifications), captured 2026-09-12.

A tip is a small transient view briefly explaining a feature, useful for new/less-obvious features or faster task completion. [TipKit](https://developer.apple.com/documentation/tipkit) provides developer guidance.

On macOS (including iPhone/iPad apps on Mac), a tooltip—called a help tag in user documentation—can appear when the pointer rests over a component. In visionOS it can appear when someone looks at an element or holds the pointer over it. Swi

**Resources:** [Onboarding](https://developer.apple.com/design/human-interface-guidelines/onboarding), [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), [Writing](https://developer.apple.com/design/human-in

Source: [Apple HIG — Offering help](https://developer.apple.com/design/human-interface-guidelines/offering-help), captured 2026-09-12.

People should understand an app or game by experiencing it. If needed, make onboarding fast, fun, and optional; it follows [launching](https://developer.apple.com/design/human-interface-guidelines/launching), rather than being part of launc

- **Teach interactively:** let people safely perform the action, discover the feature, or try the mechanic. - **Consider providing context-specific tips** instead of one large flow: focus on one current task/action and place instructions ne

- **Consider providing context-specific tips** instead of one large flow: focus on one current task/action and place instructions near its interface. [TipKit](https://developer.apple.com/documentation/tipkit) displays discovery tips.

- Keep licensing details out so the App Store can show agreements and disclaimers before download. If they must appear in onboarding, integrate them without disrupting balance. - Postpone nonessential setup/customization and provide reasona

- Postpone nonessential setup/customization and provide reasonable defaults. - If private data/resources are required before the app functions, consider integrating the permission request into onboarding so you can explain why and the benef

- If private data/resources are required before the app functions, consider integrating the permission request into onboarding so you can explain why and the benefit of granting it; otherwise present it when the person first accesses the de

**Resources:** [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), [Offering help](https://developer.apple.com/design/human-interface-guidelines/offering-help), [Discoverable design](https://developer.apple.c

Source: [Apple HIG — Onboarding](https://developer.apple.com/design/human-interface-guidelines/onboarding), captured 2026-09-12.

Source: [Ornaments](https://developer.apple.com/design/human-interface-guidelines/ornaments), captured 2026-09-12.

Source: [Outline views](https://developer.apple.com/design/human-interface-guidelines/outline-views), captured 2026-09-12.

Source: [Page controls](https://developer.apple.com/design/human-interface-guidelines/page-controls), captured 2026-09-12.

- **Use a panel for quick access to important controls or information** about the current content. - **Consider a panel (or, depending on layout, a [split view](https://developer.apple.com/design/human-interface-guidelines/split-views) pane

- **Consider a panel (or, depending on layout, a [split view](https://developer.apple.com/design/human-interface-guidelines/split-views) pane) for an inspector**, which updates automatically to show the selected item's details. Use a regula

Source: [Panels](https://developer.apple.com/design/human-interface-guidelines/panels), captured 2026-09-12.

- **Standard:** A linear list of root disk → parent folders → selected item, each with an icon and name. If too long, it hides names between the first and last items. The Finder example shows four locations. - **Pop up:** Like a [pop-up but

- **Pop up:** Like a [pop-up button](https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons), it shows the selected icon and name; clicking it opens a menu of root disk, parent folders, and selected item. When editable

**Resources:** [File management](https://developer.apple.com/design/human-interface-guidelines/file-management). [`NSPathControl`](https://developer.apple.com/documentation/appkit/nspathcontrol) is an AppKit display of file-system or virtua

Source: [Apple HIG — Path controls](https://developer.apple.com/design/human-interface-guidelines/path-controls), captured 2026-09-12.

Photo-editing extensions let people modify photos and videos inside Photos with filters or other changes. Edits always save in Photos as new files, preserving originals. A photo must be in edit mode; tapping the toolbar extension icon opens

Source: [Photo editing](https://developer.apple.com/design/human-interface-guidelines/photo-editing), captured 2026-09-12. Resources: [App extensions](https://developer.apple.com/app-extensions/), [Introducing Photo Segmentation Mattes](htt

- Consider a picker for medium-to-long lists. For a fairly short list, consider a [pull-down button](https://developer.apple.com/design/human-interface-guidelines/pull-down-buttons), because picker visual weight may be excessive. For a very

Related: [Pull-down buttons](https://developer.apple.com/design/human-interface-guidelines/pull-down-buttons), [Lists and tables](https://developer.apple.com/design/human-interface-guidelines/lists-and-tables)

Developer documentation: [`Picker`](https://developer.apple.com/documentation/swiftui/picker) (SwiftUI; selects mutually exclusive values), [`DatePicker`](https://developer.apple.com/documentation/swiftui/datepicker) (SwiftUI; selects an ab

Source: [Apple Human Interface Guidelines — Pickers](https://developer.apple.com/design/human-interface-guidelines/pickers) (captured 2026-09-12).

Source: [Playing audio](https://developer.apple.com/design/human-interface-guidelines/playing-audio), captured 2026-09-12.

Custom patterns can vary with context (a character’s jump from a tree can feel stronger than a jump in place; a collision or hit can differ from footsteps or looming danger). A **transient** is a brief tap/impulse, like tapping the Home Scr

On supported iPhone models, prefer standard toggles, sliders, and pickers for Apple-designed haptics. Where appropriate, [`UIFeedbackGenerator`](https://developer.apple.com/documentation/uikit/uifeedbackgenerator) (an abstract superclass) p

With a Magic Trackpad, [`NSHapticFeedbackPerformer`](https://developer.apple.com/documentation/appkit/nshapticfeedbackperformer) (a protocol) supports these patterns during a drag or force click:

Apple Watch Series 4 and later provides Digital Crown detents. By default, the system supplies linear detents as people rotate the Crown; table views can provide detents as items enter the screen. Use [`WKHapticType`](https://developer.appl

- [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), [Gestures](https://developer.apple.com/design/human-interface-guidelines/gestures), [Game controls](https://developer.apple.com/design/human-interface-gui

- [Delivering rich app experiences with haptics](https://developer.apple.com/documentation/corehaptics/delivering-rich-app-experiences-with-haptics), [playing haptics on game controllers](https://developer.apple.com/documentation/corehaptic

- [*Introducing Core Haptics*](https://developer.apple.com/videos/play/wwdc2019/520), [*Practice audio haptic design*](https://developer.apple.com/videos/play/wwdc2021/10278)

Source: [Playing haptics](https://developer.apple.com/design/human-interface-guidelines/playing-haptics) (captured 2026-09-12).

|Mode|Default aspect ratios|Result| |---|---|---| |Full-screen / `aspect-fill`|Wide, 2:1 through 2.40:1|Fills the display; edges may crop ([`AVLayerVideoGravity.resizeAspectFill`](https://developer.apple.com/documentation/avfoundation/avlay

|---|---|---| |Full-screen / `aspect-fill`|Wide, 2:1 through 2.40:1|Fills the display; edges may crop ([`AVLayerVideoGravity.resizeAspectFill`](https://developer.apple.com/documentation/avfoundation/avlayervideogravity/resizeaspectfill); Ob

|Full-screen / `aspect-fill`|Wide, 2:1 through 2.40:1|Fills the display; edges may crop ([`AVLayerVideoGravity.resizeAspectFill`](https://developer.apple.com/documentation/avfoundation/avlayervideogravity/resizeaspectfill); Objective-C `AVL

|Fit-to-screen / `aspect`|Standard (4:3, 16:9, and anything up to 2:1) or ultrawide (above 2.40:1)|Shows the whole video with letterboxing/pillarboxing as needed ([`AVLayerVideoGravity.resizeAspect`](https://developer.apple.com/documentatio

In iOS, iPadOS, tvOS, and visionOS, provide additional metadata (image, title, description, and other useful information) only when it adds value and keep it from obscuring playback. Use [`AVPlayerItem.externalMetadata`](https://developer.a

In tvOS, consider a transport control for playback actions (such as favoriting) or a custom content tab for succinct supplementary information/recommendations. Keep actions to one or two steps. tvOS and visionOS built-in players provide tra

Don’t mix audio sources as viewers switch modes. For example, PiP may mute a full-screen video; if a game started meanwhile fails to handle secondary audio and the video is unmuted, both sounds mix. Handle the secondary-audio hint ([Swift `

- **tvOS:** Keep logos/countdowns small and unobtrusive. Avoid large overlays; image-retention-prone devices favor short, translucent SDR graphics over bright opaque ones. For interactive quizzes, surveys, or progress checks, delay pausing 

- **visionOS:** Let people choose when playback starts, use a small resizable window, and keep surroundings visible. In full immersion, use the system’s predictable player location and keep virtual content from obscuring playback controls o

- [Playing audio](https://developer.apple.com/design/human-interface-guidelines/playing-audio), [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback)

- [`AVPlayerViewController`](https://developer.apple.com/documentation/avkit/avplayerviewcontroller), [`VideoPlayer`](https://developer.apple.com/documentation/avkit/videoplayer), [AVFoundation media playback](https://developer.apple.com/do

- [*Create a great video playback experience*](https://developer.apple.com/videos/play/wwdc2022/10147), [*Explore video experiences for visionOS*](https://developer.apple.com/videos/play/wwdc2025/304), [*Deliver a great playback experience 

Source: [Playing video](https://developer.apple.com/design/human-interface-guidelines/playing-video) (captured 2026-09-12).

Source: [Pointing devices](https://developer.apple.com/design/human-interface-guidelines/pointing-devices), captured 2026-09-12.

- Use it when those options/states affect content or the surrounding view. Use a [pull-down button](https://developer.apple.com/design/human-interface-guidelines/pull-down-buttons) for actions, multiple selection, or a submenu.

[Buttons](https://developer.apple.com/design/human-interface-guidelines/buttons), [Menus](https://developer.apple.com/design/human-interface-guidelines/menus). Developer documentation: [`MenuPickerStyle`](https://developer.apple.com/documen

Source: [Apple HIG — Pop-up buttons](https://developer.apple.com/design/human-interface-guidelines/pop-up-buttons), captured 2026-09-12.

Source: [Popovers](https://developer.apple.com/design/human-interface-guidelines/popovers), captured 2026-09-12.

- Make Print discoverable: macOS File menu; iOS/iPadOS toolbar button opening an [action sheet](https://developer.apple.com/design/human-interface-guidelines/action-sheets); optionally an addable macOS toolbar button.

- Related: [File management](https://developer.apple.com/design/human-interface-guidelines/file-management), [File menu](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar#File-menu)

- APIs: [UIPrintInteractionController](https://developer.apple.com/documentation/uikit/uiprintinteractioncontroller) (iOS printing UI), [NSDocument](https://developer.apple.com/documentation/appkit/nsdocument) (macOS document interface).

Source: [Printing](https://developer.apple.com/design/human-interface-guidelines/printing) (captured 2026-09-12).

[Credential-related source omitted]

[Credential-related source omitted]

Source: [Privacy](https://developer.apple.com/design/human-interface-guidelines/privacy), captured 2026-09-12.

Source: [Progress indicators](https://developer.apple.com/design/human-interface-guidelines/progress-indicators), captured 2026-09-12.

Source: [Pull-down buttons](https://developer.apple.com/design/human-interface-guidelines/pull-down-buttons), captured 2026-09-12.

Related: [Ratings and reviews](https://developer.apple.com/design/human-interface-guidelines/ratings-and-reviews)

Developer documentation: [`NSLevelIndicator.Style.rating`](https://developer.apple.com/documentation/appkit/nslevelindicator/style/rating) — AppKit; Objective-C alias: `NSLevelIndicatorStyleRating`.

Source: [Apple Human Interface Guidelines — Rating indicators](https://developer.apple.com/design/human-interface-guidelines/rating-indicators) (captured 2026-09-12).

Prefer the system prompt on iOS, iPadOS, and macOS. The system checks for prior feedback and, if there isn’t any, shows a nonintrusive in-app request for a rating and optional written review; `RequestReviewAction` itself asks StoreKit to re

Before resetting the summary of individual ratings received since the previous reset after a new release, weigh the benefit of reflecting the current version against the likely disadvantage of having fewer total ratings, which can discourag

Source: [Apple Human Interface Guidelines — Ratings and Reviews](https://developer.apple.com/design/Human-Interface-Guidelines/ratings-and-reviews), captured 2026-09-12.

- **If your live-viewing app provides an electronic program guide ([EPG](https://developer.apple.com/design/human-interface-guidelines/live-viewing-apps#EPG-experience)), respond to a compatible remote's EPG buttons as people expect**: "gui

Developer: [Providing Channel Navigation](https://developer.apple.com/documentation/tvservices/providing-channel-navigation)

Source: [Remotes](https://developer.apple.com/design/human-interface-guidelines/remotes), captured 2026-09-12.

Resources: [Research & Care > ResearchKit](https://www.researchandcare.org/researchkit/) · [Research & Care > Developers](https://www.researchandcare.org/developers/) · [ResearchKit GitHub project](https://github.com/ResearchKit/ResearchKit

Source: [Apple Human Interface Guidelines — ResearchKit](https://developer.apple.com/design/Human-Interface-Guidelines/researchkit), captured 2026-09-12.

Support Arabic, Hebrew, and other RTL languages by reversing the interface as needed to match their reading direction. System UI frameworks and standard layouts flip automatically in RTL, so custom work is mainly for fine-tuning layout and 

Developer references: [Preparing views for localization](https://developer.apple.com/documentation/swiftui/preparing-views-for-localization), [Creating custom symbol images for your app](https://developer.apple.com/documentation/uikit/creat

Source: [Apple HIG — Right to left](https://developer.apple.com/design/human-interface-guidelines/right-to-left), captured 2026-09-12.

Source: [Scroll views](https://developer.apple.com/design/human-interface-guidelines/scroll-views), captured 2026-09-12.

A search field lets people search a collection for entered terms. It is an editable text field with a Search icon, Clear button, and placeholder. Scope bars and tokens can filter or refine it; choose the access pattern according to app goal

A scope bar filters/adjusts search scope; a token visually encapsulates a selectable, editable search term and filters additional terms. Use scope bars before or after a search for defined categories, starting broad and letting people narro

A tvOS search screen is a specialized keyboard screen: it accepts text and displays results beneath the keyboard in a customizable view, optionally with a scope bar. Order it field and keyboard, then scope bar, then results. People generall

Resources: [`searchable(text:placement:prompt:)`](https://developer.apple.com/documentation/swiftui/view/searchable(text:placement:prompt:)) marks a view searchable and configures its field; [UISearchBar](https://developer.apple.com/documen

Source: [Apple HIG — Search fields](https://developer.apple.com/design/human-interface-guidelines/search-fields), captured 2026-09-12.

Search spans devices, apps, and documents/files. In apps, people generally expect a [search field](https://developer.apple.com/design/human-interface-guidelines/search-fields). When it makes sense, personalize with knowledge of app interact

- Give important search a primary position (Notes’ bottom toolbar; Photos/Apple TV’s dedicated tab). - Aim for one app-wide location; distinct sections may also need local search (iOS Music filters current songs/albums). - Show current scop

- Aim for one app-wide location; distinct sections may also need local search (iOS Music filters current songs/albums). - Show current scope with descriptive placeholder, [scope bar](https://developer.apple.com/design/human-interface-guidel

- Show current scope with descriptive placeholder, [scope bar](https://developer.apple.com/design/human-interface-guidelines/search-fields#Scope-bars-and-tokens), or title (Mail keeps the mailbox visible).

- Offer recents before typing or predictive suggestions while typing; [`searchSuggestions(_:)`](https://developer.apple.com/documentation/swiftui/view/searchsuggestions(_:)) configures a view’s suggestions. If showing history, consider priv

On iOS, iPadOS, and macOS, [Spotlight](https://developer.apple.com/documentation/corespotlight/adding-your-app-s-content-to-spotlight-indexes) searches across apps and the web. Index app content with descriptive metadata; Spotlight extracts

- For custom file types, supply a Spotlight File Importer plug-in describing their metadata; [CSImportExtension](https://developer.apple.com/documentation/corespotlight/csimportextension) provides searchable attributes for supported types.

- Use Spotlight for advanced in-app file search: a button might search from the current selection, then show custom results or a filtered subset. - Prefer system open/save views, which generally include a field to search/filter the entire s

- Prefer system open/save views, which generally include a field to search/filter the entire system; see [File management](https://developer.apple.com/design/human-interface-guidelines/file-management).

- If producing custom file types, implement a [Quick Look](https://developer.apple.com/documentation/quicklook) generator so Spotlight and other apps can preview documents. The Quick Look framework can also create in-app previews or perform

Source: [Apple HIG — Searching](https://developer.apple.com/design/human-interface-guidelines/searching), captured 2026-09-12.

Source: [Segmented controls](https://developer.apple.com/design/human-interface-guidelines/segmented-controls), captured 2026-09-12.

- Choose defaults that serve most people; for example, optimize a game for its device rather than ask after launch ([Metal guidance](https://developer.apple.com/documentation/metal/improving-your-games-graphics-performance-and-settings)).

Choosing Settings from the App menu opens a window, typically a toolbar of related panes. Put Settings in the [App menu](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar#App-menu), not a window toolbar; put documen

- Related: [Onboarding](https://developer.apple.com/design/human-interface-guidelines/onboarding)

- APIs: [SwiftUI Settings](https://developer.apple.com/documentation/swiftui/settings) (scene for viewing/modifying app settings); [UserDefaults / NSUserDefaults](https://developer.apple.com/documentation/foundation/userdefaults) (systemwid

Source: [Settings](https://developer.apple.com/design/human-interface-guidelines/settings) (captured 2026-09-12).

Use symbols for objects or concepts wherever interface icons appear, including toolbars, tab bars, context menus, and text. Individual symbols and features depend on the target OS version; symbols introduced in a year aren't available on ea

[Typography](https://developer.apple.com/design/human-interface-guidelines/typography) · [Icons](https://developer.apple.com/design/human-interface-guidelines/icons) · [SF Symbols](https://developer.apple.com/sf-symbols/) · [Symbols framewo

Source: [Apple Human Interface Guidelines — SF Symbols](https://developer.apple.com/design/Human-Interface-Guidelines/sf-symbols), captured 2026-09-12.

Source: [SharePlay](https://developer.apple.com/design/human-interface-guidelines/shareplay), captured 2026-09-12.

Resources: [ShazamKit](https://developer.apple.com/documentation/shazamkit) and [Explore ShazamKit](https://developer.apple.com/videos/play/wwdc2021/10044).

Source: [Apple Human Interface Guidelines — ShazamKit](https://developer.apple.com/design/Human-Interface-Guidelines/shazamkit), captured 2026-09-12.

Source: [Sheets](https://developer.apple.com/design/human-interface-guidelines/sheets), captured 2026-09-12.

- In iOS, iPadOS, and macOS, let rich content extend beneath a Liquid Glass sidebar by horizontal scrolling or a background extension effect that mirrors, flips, and blurs adjacent content to the window edge. Don’t stop the image at the sid

**iOS/iPadOS:** [`sidebarAdaptable`](https://developer.apple.com/documentation/swiftui/tabviewstyle/sidebaradaptable) lets the app choose whether to open as a sidebar or tab bar; both provide a switch button, and the style adapts to platfor

Source: [Apple HIG — Sidebars](https://developer.apple.com/design/human-interface-guidelines/sidebars), captured 2026-09-12.

Sign in with Apple provides fast, private sign-in to apps and websites using an existing Apple Account. It supports Face ID, Touch ID, or Optic ID, includes two-factor authentication, and avoids profiling people or their activity in apps. I

Display the button prominently, at least as large as other sign-in buttons and without requiring scrolling. Prefer the system API: it supplies Apple-approved appearance and proportions, localized titles, configurable corner radius on iOS/ma

For iOS, macOS, or the web, create a custom button only if the interface requires it—for example, to align authentication logos, use a logo-only control, or coordinate font, bezel, or background. App Review evaluates it. Keep the button ins

[Sign in with Apple button](https://appleid.apple.com/signinwithapple/button) · [Authentication Services](https://developer.apple.com/documentation/authenticationservices) · [Apple Design Resources](https://developer.apple.com/design/resour

Source: [Apple Human Interface Guidelines — Sign in with Apple](https://developer.apple.com/design/Human-Interface-Guidelines/sign-in-with-apple), captured 2026-09-12.

- **Refer to Siri by name**, ideally just *Siri*; don't use pronouns like *she*, *him* or *her* (see [trademark guidelines](https://www.apple.com/legal/intellectual-property/guidelinesfor3rdparties.html)).

Source: [Siri](https://developer.apple.com/design/human-interface-guidelines/siri), captured 2026-09-12.

Source: [Sliders](https://developer.apple.com/design/human-interface-guidelines/sliders), captured 2026-09-12.

When someone performs a task with Siri, Spotlight, or Shortcuts, a snippet is a compact view that shows a result or asks for confirmation. Include one with an [app intent](https://developer.apple.com/documentation/appintents) when a task ne

- **Ensure legibility.** Provide sufficient contrast against the system background in light and dark appearances and consistent content margins. - **Keep content concise.** Lightweight interactions should remain short and legible; account f

- **Keep content concise.** Lightweight interactions should remain short and legible; account for preferred text size. For more result detail, deep-link into the app instead of overloading the view. - **Label the primary confirmation action

- **Label the primary confirmation action descriptively.** Choose a system-provided [`ConfirmationActionName`](https://developer.apple.com/documentation/appintents/confirmationactionname) or custom label; **Order** communicates a coffee ord

- [Displaying static and interactive snippets](https://developer.apple.com/documentation/appintents/displaying-static-and-interactive-snippets)

- [Design interactive snippets](https://developer.apple.com/videos/play/wwdc2025/281)

Source: [Snippets](https://developer.apple.com/design/human-interface-guidelines/snippets) (captured 2026-09-12).

Distance, occlusion, and shadow communicate depth. Vision Pro also uses color temperature, reflections, and shadow; these cues change as an object or viewer moves. Small amounts of depth can make even 2D windows feel natural, and SwiftUI ad

- Avoid too many windows: they can obscure surroundings, feel constricting, and make relocation cumbersome. - Prefer standard indirect gestures, which work at any distance with hands outside the field of view. A direct gesture touches a vir

- Prefer standard indirect gestures, which work at any distance with hands outside the field of view. A direct gesture touches a virtual object with a finger; if you support direct gestures, consider reserving them for nearby objects inviti

- People can press the [Digital Crown](https://developer.apple.com/design/human-interface-guidelines/digital-crown) to recenter content in their field of view; the app needs no special support.

- Leave enough space around interactive components for comfortable gaze hover and to keep hover from crowding other content. Regular-size buttons should have centers at least 60 points apart, leaving 16 points or more between them; controls

For related window and layout guidance, see [Windows > visionOS](https://developer.apple.com/design/human-interface-guidelines/windows#visionOS), [Layout > visionOS](https://developer.apple.com/design/human-interface-guidelines/layout#visio

- [Presenting windows and spaces](https://developer.apple.com/documentation/visionos/presenting-windows-and-spaces); [Positioning and sizing windows](https://developer.apple.com/documentation/visionos/positioning-and-sizing-windows); [Addin

- [Meet SwiftUI spatial layout](https://developer.apple.com/videos/play/wwdc2025/273); [Principles of spatial design](https://developer.apple.com/videos/play/wwdc2023/10072); [Design for spatial user interfaces](https://developer.apple.com/

Source: [Apple HIG — Spatial layout](https://developer.apple.com/design/human-interface-guidelines/spatial-layout), captured 2026-09-12.

- Persistently highlight the current selection in each pane leading to a detail view; the selected appearance explains relationships and preserves orientation. - Consider [drag and drop](https://developer.apple.com/design/human-interface-gu

- Consider [drag and drop](https://developer.apple.com/design/human-interface-guidelines/drag-and-drop) between panes for moving content.

**iPadOS:** A split view can have two vertical panes (Mail) or three (Keynote); design for narrow, compact, and intermediate fluid widths so navigation among panes remains logical. [`NavigationSplitView`](https://developer.apple.com/documen

**macOS:** Panes can be vertical (stacked), horizontal (side by side), or combined; draggable dividers resize them. If panes are resizable, set reasonable minimum/maximum defaults so the divider stays visible. Consider hiding panes when use

**visionOS:** Prefer a split view for supplementary information so people stay in context; a new window can confuse navigation/repositioning and complicate view relationships. Use a [sheet](https://developer.apple.com/design/human-interface

Source: [Apple HIG — Split views](https://developer.apple.com/design/human-interface-guidelines/split-views), captured 2026-09-12.

- Keep content beneath it visually obscured and the status information readable. Its default transparent background can reveal controls that appear interactive even though people can’t use them; prefer a blurred scroll-edge effect via [`Scr

Developer references: [`UIStatusBarStyle`](https://developer.apple.com/documentation/uikit/uistatusbarstyle) (status-bar style constants) and [`preferredStatusBarStyle`](https://developer.apple.com/documentation/uikit/uiviewcontroller/prefe

Related: [Pickers](https://developer.apple.com/design/human-interface-guidelines/pickers), [Text fields](https://developer.apple.com/design/human-interface-guidelines/text-fields)

Developer documentation: [`UIStepper`](https://developer.apple.com/documentation/uikit/uistepper) (UIKit; increments or decrements a value); [`NSStepper`](https://developer.apple.com/documentation/appkit/nsstepper) (AppKit; up/down arrow bu

Source: [Apple Human Interface Guidelines — Steppers](https://developer.apple.com/design/human-interface-guidelines/steppers) (captured 2026-09-12).

- Use tabs for navigation, not current-view actions; use a [toolbar](https://developer.apple.com/design/human-interface-guidelines/toolbars) for actions. Keep the bar visible between sections (a temporary, self-contained modal may cover it)

- Avoid overflow. On iOS/iPadOS, insufficient width turns the trailing item into **More**, hiding the remaining items in a separate list. Don’t disable or hide unavailable sections; explain an empty one instead. - Label tabs, preferably wit

- Label tabs, preferably with single words. SF Symbols adapt between compact (icon above label) and regular (beside label) layouts; prefer filled symbols. Use [Apple Design Resources](https://developer.apple.com/design/resources/) for custo

- Reserve badges (red oval, white number or exclamation point) for critical new/updated information. Keep labels distinct from colorful content; use monochrome or a differentiated accent with [Liquid Glass color](https://developer.apple.com

**iOS:** The bar floats at the bottom over [Liquid Glass](https://developer.apple.com/design/human-interface-guidelines/materials#Liquid-Glass), allowing content to peek through. With an attached accessory such as Music’s MiniPlayer, scroll

**iPadOS:** The bar is near the top and can be fixed or offer conversion to a sidebar ([`tabBarOnly`](https://developer.apple.com/documentation/swiftui/tabviewstyle/tabbaronly), [`sidebarAdaptable`](https://developer.apple.com/documentation

Developer references: [`TabView`](https://developer.apple.com/documentation/swiftui/tabview), [`TabViewBottomAccessoryPlacement`](https://developer.apple.com/documentation/swiftui/tabviewbottomaccessoryplacement), [`Enhancing your app’s con

watchOS presents tab views as pages using [page controls](https://developer.apple.com/design/human-interface-guidelines/page-controls). The indicator beside the Digital Crown enlarges the current dot to signal scrolling within current conte

Related: [Tab bars](https://developer.apple.com/design/human-interface-guidelines/tab-bars), [Segmented controls](https://developer.apple.com/design/human-interface-guidelines/segmented-controls).

API: [`NSTabView`](https://developer.apple.com/documentation/appkit/nstabview) (AppKit tab view).

Source: [Apple Human Interface Guidelines — Tab views](https://developer.apple.com/design/human-interface-guidelines/tab-views), captured 2026-09-12.

Tap to Pay on iPhone lets merchants accept contactless payments in an iPhone app without external hardware. It works alongside payment-acceptance hardware/accessories. Integration requires a supported payment service provider (PSP), the Tap

- Before enabling/configuring a merchant device, use ProximityReader to check the status of the **terms and conditions** and show acceptance only when needed. Help merchants accept them **before** customer-facing checkout; initial configura

- Provide a quick tutorial covering every supported payment type: launch each checkout, help the customer position a contactless card or digital wallet near the merchant iPhone, and handle PIN entry including accessibility mode. Offer it th

- Always expose Tap to Pay on iPhone as a checkout option, enabled or not. Tapping it can present terms, complete configuration, then automatically open the Tap to Pay screen without leaving checkout. Keep other payment options where necess

- Configure early: perform initial setup and call [`PaymentCardReader.prepare(using:)`](https://developer.apple.com/documentation/proximityreader/paymentcardreader/prepare(using:)) when the app starts and after every foreground transition. 

- Start PSP processing as soon as possible: set `returnReadResultImmediately` so the framework can return a successful read before the system UI finishes its checkmark animation. [`returnReadResultImmediately`](https://developer.apple.com/d

- After the Tap to Pay animation finishes, show an authorization progress indicator before the transaction-result screen. Authorization may take several seconds depending on PSP and merchant-device connectivity. Apple points to [`PaymentCar

- If the tap cannot complete because the card is unreadable, unsupported by the payment network, not valid for the amount, or lacks online PIN entry, let the merchant accept cash/another tender, use external hardware or a payment link, or r

- For a system error the merchant must fix, explain the problem and recommend the resolution; for an unsupported iOS version, use an alert recommending the latest update. See [`PaymentCardReaderSession.ReadError`](https://developer.apple.co

Resource: [Tap to Pay on iPhone](https://developer.apple.com/tap-to-pay/).

Source: [Tap to Pay on iPhone](https://developer.apple.com/design/human-interface-guidelines/tap-to-pay-on-iphone) (captured 2026-09-12).

Source: [Text fields](https://developer.apple.com/design/human-interface-guidelines/text-fields), captured 2026-09-12.

- **Use a text view for long, editable, or specially formatted text.** It offers the most options for specialized display and text input; use a label for small read-only text and a text field for small editable text. - **Keep text legible**

- **Keep text legible** across fonts, colors, and alignments; consider Dynamic Type when people change device text size, and test accessibility settings such as bold text. See [Accessibility](https://developer.apple.com/design/human-interfa

- **iOS and iPadOS:** While editing, show a keyboard type suited to the text view’s content to streamline entry; see [Virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards).

- Related: [Combo boxes](https://developer.apple.com/design/human-interface-guidelines/combo-boxes).

- Developer documentation: [`Text`](https://developer.apple.com/documentation/swiftui/text) — SwiftUI (one or more lines of read-only text); [`UITextView`](https://developer.apple.com/documentation/uikit/uitextview) — UIKit (scrollable, mul

Source: [Apple HIG — Text views](https://developer.apple.com/design/human-interface-guidelines/text-views), captured 2026-09-12.

- **Support the standard menus and their order.** The system implements many standard items (e.g., Edit > Copy for text selected in a standard text field). - **Disable, don't hide, unavailable items**; always show the same set. - **Use the 

- **Disable, don't hide, unavailable items**; always show the same set. - **Use the system's icons** for actions like Copy, Share and Delete, everywhere ([Standard icons](https://developer.apple.com/design/human-interface-guidelines/icons#S

- **Use the system's icons** for actions like Copy, Share and Delete, everywhere ([Standard icons](https://developer.apple.com/design/human-interface-guidelines/icons#Standard-icons)).

At the trailing end of the menu bar. With the Help Book format, macOS automatically adds a search field at the top. See [Offering help](https://developer.apple.com/design/human-interface-guidelines/offering-help) and `NSHelpManager`.

Source: [The menu bar](https://developer.apple.com/design/human-interface-guidelines/the-menu-bar), captured 2026-09-12.

Source: [Toggles](https://developer.apple.com/design/human-interface-guidelines/toggles), captured 2026-09-12.

Tokens can also represent search terms in some situations; see [Search fields](https://developer.apple.com/design/human-interface-guidelines/search-fields).

- Add value with a [context menu](https://developer.apple.com/design/human-interface-guidelines/context-menus) offering token information or editing options; in Mail, a recipient-token menu can edit the name, mark it as a VIP, view its cont

**Resources:** [Text fields](https://developer.apple.com/design/human-interface-guidelines/text-fields), [Search fields](https://developer.apple.com/design/human-interface-guidelines/search-fields), and [Context menus](https://developer.app

Source: [Apple HIG — Token fields](https://developer.apple.com/design/human-interface-guidelines/token-fields), captured 2026-09-12.

A toolbar gives access to frequent commands, controls, navigation, and search in logical groups along a view’s top or bottom edge. It can contain the view title, navigation/search controls, and button/menu actions; in iOS, a navigation-spec

- Keep items distinguishable and activatable; define what moves to overflow as width narrows. macOS/iPadOS add system overflow when items no longer fit—don’t add one manually or design for default overflow. Add **More** only when needed, pu

- In iPadOS/macOS, consider customization for many, advanced, or long-session actions. Reduce backgrounds/tints that interfere with system effects; let content set appearance and use [`ScrollEdgeEffectStyle`](https://developer.apple.com/doc

Group by function/frequency and consistently across platforms; dedicate distinct groups to navigation/critical actions (Done, Close, Save); generally use no more than **three groups**. Separate text from symbol actions so they don’t appear 

**iOS:** Put only essential actions in the main area; use More for the rest. Use a large title to help people stay oriented; by default it becomes standard while scrolling and returns to large at the top. [`prefersLargeTitles`](https://deve

**watchOS:** Buttons may sit in top corners or at the bottom and stay visible above scrolling content. A scrolling-view button is hidden until people scroll up; use it for an important related action that isn’t the app’s primary function (M

Developer references: [`Toolbars`](https://developer.apple.com/documentation/swiftui/toolbars), [`UIToolbar`](https://developer.apple.com/documentation/uikit/uitoolbar), [`NSToolbar`](https://developer.apple.com/documentation/appkit/nstoolb

The tvOS Home Screen area above the Dock showcasing the focused app's content, optionally as full-screen, swipeable previews. Templates: [Apple Design Resources](https://developer.apple.com/design/resources/#tvos-apps).

- **Personalize.** You can show targeted recommendations and let people resume playback or gameplay. - **Avoid showing advertisements or prices.** Purchasable content is fine, but prefer focusing on new content; consider showing prices only

- **Avoid showing advertisements or prices.** Purchasable content is fine, but prefer focusing on new content; consider showing prices only when people show interest. - **Showcase dynamic content.** You can use static images if necessary, b

- **Showcase dynamic content.** You can use static images if necessary, but people typically prefer dynamic, newest or highest rated content; prefer [layered images](https://developer.apple.com/design/human-interface-guidelines/images#Layer

Source: [Top Shelf](https://developer.apple.com/design/human-interface-guidelines/top-shelf), captured 2026-09-12.

- **San Francisco (SF)**, sans serif: SF Pro, SF Compact, SF Arabic, SF Armenian, SF Georgian, SF Hebrew, SF Mono. All but SF Mono have rounded variants you can use to match soft or rounded UI elements or for an alternative voice. - **New Y

- **New York (NY)**, serif, works alone and alongside SF. [Download SF and NY](https://developer.apple.com/fonts/).

- **Make sure custom fonts are legible**, guided by the minimum sizes for styles and weights in [Specifications](#specifications). - **Implement accessibility features for custom fonts.** System fonts automatically support Dynamic Type (whe

- **Implement accessibility features for custom fonts.** System fonts automatically support Dynamic Type (where available) and accessibility features such as Bold Text; make sure a custom font implements the same behaviors ([Applying custom

Dynamic Type lets people adjust text size system-wide in iOS, iPadOS, tvOS, visionOS and watchOS. Size tables are in [Specifications](#specifications) and the [Apple Design Resources](https://developer.apple.com/design/resources/). In Unity

Body and title Dynamic Type styles are bolder; Extra Large Title 1 and 2 serve wide, editorial-style layouts. For vibrancy as hierarchy, see [Materials > visionOS](https://developer.apple.com/design/human-interface-guidelines/materials#visi

Developer: [Text input and output](https://developer.apple.com/documentation/SwiftUI/Text-input-and-output) (SwiftUI), [Text display and fonts](https://developer.apple.com/documentation/UIKit/text-display-and-fonts) (UIKit), [Fonts](https:/

Source: [Typography](https://developer.apple.com/design/human-interface-guidelines/typography), captured 2026-09-12.

- Related: [Feedback](https://developer.apple.com/design/human-interface-guidelines/feedback), [Pointing devices](https://developer.apple.com/design/human-interface-guidelines/pointing-devices), [Standard keyboard shortcuts](https://develop

- API: [UndoManager / NSUndoManager](https://developer.apple.com/documentation/foundation/undomanager), a general-purpose operation recorder enabling undo and redo (Swift / Objective-C names).

- Video: [Essential Design Principles](https://developer.apple.com/videos/play/wwdc2017/802)

Source: [Undo and redo](https://developer.apple.com/design/human-interface-guidelines/undo-and-redo) (captured 2026-09-12).

Selecting a text field with the Siri Remote shows a linear keyboard; other devices show a grid keyboard screen, and content layout adapts automatically. [Digit entry views](https://developer.apple.com/design/human-interface-guidelines/digit

Source: [Virtual keyboards](https://developer.apple.com/design/human-interface-guidelines/virtual-keyboards), captured 2026-09-12.

Source: [VoiceOver](https://developer.apple.com/design/human-interface-guidelines/voiceover), captured 2026-09-12.

Source: [Wallet](https://developer.apple.com/design/human-interface-guidelines/wallet), captured 2026-09-12.

- **Share faces (watchOS 7+) featuring your complications** via your app, website, Messages, Mail or social media. Ideally, support multiple complications to showcase. Some faces also take a system accent color, images, or styles. The syste

- **Preview each shared face.** Email the face to yourself from the iOS Watch app to get a preview with an illustrated bezel, for web and watchOS/iOS apps, or replace it with a high-fidelity hardware bezel from [Apple Design Resources](http

Developer: [Sharing an Apple Watch face](https://developer.apple.com/documentation/ClockKit/sharing-an-apple-watch-face) (ClockKit)

Source: [Watch faces](https://developer.apple.com/design/human-interface-guidelines/watch-faces), captured 2026-09-12.

- [Webkit.org](https://webkit.org/).

- [`WKWebView`](https://developer.apple.com/documentation/webkit/wkwebview) — WebKit object that displays interactive web content, such as for an in-app browser.

- [Explore WKWebView additions](https://developer.apple.com/videos/play/wwdc2021/10032).

Source: [Apple HIG — Web views](https://developer.apple.com/design/human-interface-guidelines/web-views), captured 2026-09-12.

Source: [Widgets](https://developer.apple.com/design/human-interface-guidelines/widgets), captured 2026-09-12.

Source: [Windows](https://developer.apple.com/design/human-interface-guidelines/windows), captured 2026-09-12.

Source: [Workouts](https://developer.apple.com/design/human-interface-guidelines/workouts), captured 2026-09-12.

- **Match your tone to the context**: what people are doing, physically and in the app. It affects both wording and how text is displayed. - **Be clear.** Use easily understood words, as few as you can. When in doubt, read it aloud. - **Wri

- **Write for everyone** in simple, plain language, with accessibility and localization in mind; avoid jargon and gendered terminology. See [Writing inclusively](https://help.apple.com/applestyleguide/#/apdcb2a65d68).

Source: [Writing](https://developer.apple.com/design/human-interface-guidelines/writing), captured 2026-09-12.

#!/usr/bin/env python3

def lower_link_urls(text):     return re.sub(r'https://developer\.apple\.com/[^\s)]+', lambda m: m.group().lower(), text)

return re.sub(r'https://developer\.apple\.com/[^\s)]+', lambda m: m.group().lower(), text)

Executable file

#!/usr/bin/env python3

ROOT = '/design/human-interface-guidelines' BASE = 'https://developer.apple.com'

BASE = 'https://developer.apple.com'

def fetch(path, kind, output):

for attempt in range(3):         try:             req = urllib.request.Request(url, headers={'User-Agent': 'HIGAgentSkills-source-capture/2.0'})

try:             req = urllib.request.Request(url, headers={'User-Agent': 'HIGAgentSkills-source-capture/2.0'})             with urllib.request.urlopen(req, timeout=35) as response:

req = urllib.request.Request(url, headers={'User-Agent': 'HIGAgentSkills-source-capture/2.0'})

with urllib.request.urlopen(req, timeout=35) as response:

def capture(path, output):     md, text, _ = fetch(path, 'md', output)

md, text, _ = fetch(path, 'md', output)

js, _, data = fetch(path, 'json', output)

external = set()     for target in LINK_RE.findall(text):         if target.startswith(('/', 'https://developer.apple.com/')) and not normalize(target):

for target in LINK_RE.findall(text):         if target.startswith(('/', 'https://developer.apple.com/')) and not normalize(target):             external.add(urllib.parse.urljoin(BASE, target))

if target.startswith(('/', 'https://developer.apple.com/')) and not normalize(target):             external.add(urllib.parse.urljoin(BASE, target))     return {'slug': slug_for_path(path), 'path': path, 'apple_url': BASE + path,

Executable file

Executable file

#!/usr/bin/env python3

DATA_BASE = "https://developer.apple.com/tutorials/data"

WEB_BASE = "https://developer.apple.com"

ROOT_PATH = "/design/human-interface-guidelines" HIG_PATH_RE = re.compile(r"/design/(?:human|Human)-(?:interface|Interface)-(?:guidelines|Guidelines)[\w\-/]*(?:#[\w\-]+)?") USER_AGENT = "HIGAgentSkills-updater/1.0 (+https://github.com/justi

USER_AGENT = "HIGAgentSkills-updater/1.0 (+https://github.com/justinwetch/HIGAgentSkills)"

def fetch_text(url: str, retries: int, delay: float) -> tuple[str | None, str | None]:     request = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})

request = urllib.request.Request(url, headers={"User-Agent": USER_AGENT})

for attempt in range(retries + 1):         try:             with urllib.request.urlopen(request, timeout=30) as response:

try:             with urllib.request.urlopen(request, timeout=30) as response:                 return response.read().decode("utf-8"), None

with urllib.request.urlopen(request, timeout=30) as response:

Executable file

#!/usr/bin/env python3

#!/usr/bin/env python3

Executable file

#!/usr/bin/env python3

Executable file

Executable file

[Credential-related source omitted]

Executable file

Executable file

Executable file

#!/usr/bin/env python3

url = ref.get("url") or identifier or ""         if url and str(url).startswith("/"):             url = "https://developer.apple.com" + str(url)

if url and str(url).startswith("/"):             url = "https://developer.apple.com" + str(url)         return f"[{title}]({url})" if url else str(title)

url = "https://developer.apple.com" + str(url)

url = ref.get("url") or identifier             if isinstance(url, str) and url.startswith("/"):                 url = "https://developer.apple.com" + url

if isinstance(url, str) and url.startswith("/"):                 url = "https://developer.apple.com" + url             lines.append(f"- [{title}]({url})")

url = "https://developer.apple.com" + url

url = ref.get("url") or identifier                 if isinstance(url, str) and url.startswith("/"):                     url = "https://developer.apple.com" + url

if isinstance(url, str) and url.startswith("/"):                     url = "https://developer.apple.com" + url                 lines.append(f"- [{title}]({url})")

url = "https://developer.apple.com" + url

#!/usr/bin/env python3

#!/usr/bin/env python3

Executable file

"slug": "accessibility",     "title": "Accessibility",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/accessibility",

"title": "Accessibility",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/accessibility",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/accessibility.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/accessibility",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/accessibility.json",

"slug": "action-button",     "title": "Action button",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-button",

"title": "Action button",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-button",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/action-button.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-button",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/action-button.json",

"slug": "action-sheets",     "title": "Action sheets",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-sheets",

"title": "Action sheets",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-sheets",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/action-sheets.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/action-sheets",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/action-sheets.json",

"slug": "activity-rings",     "title": "Activity rings",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-rings",

"title": "Activity rings",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-rings",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/activity-rings.js

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-rings",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/activity-rings.json",

"slug": "activity-views",     "title": "Activity views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-views",

"title": "Activity views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-views",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/activity-views.js

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/activity-views",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/activity-views.json",

"slug": "airplay",     "title": "AirPlay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/airplay",

"title": "AirPlay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/airplay",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/airplay.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/airplay",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/airplay.json",

"slug": "alerts",     "title": "Alerts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/alerts",

"title": "Alerts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/alerts",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/alerts.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/alerts",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/alerts.json",

"slug": "always-on",     "title": "Always On",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/always-on",

"title": "Always On",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/always-on",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/always-on.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/always-on",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/always-on.json",

"slug": "app-clips",     "title": "App Clips",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-clips",

"title": "App Clips",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-clips",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-clips.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-clips",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-clips.json",

"slug": "app-icons",     "title": "App icons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-icons",

"title": "App icons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-icons",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-icons.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-icons",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-icons.json",

"slug": "app-shortcuts",     "title": "App Shortcuts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-shortcuts",

"title": "App Shortcuts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-shortcuts",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-shortcuts.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/app-shortcuts",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/app-shortcuts.json",

"slug": "apple-pay",     "title": "Apple Pay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pay",

"title": "Apple Pay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pay",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/apple-pay.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pay",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/apple-pay.json",

"slug": "apple-pencil-and-scribble",     "title": "Apple Pencil and Scribble",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble",

"title": "Apple Pencil and Scribble",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidel

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/apple-pencil-and-scribble",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/apple-pencil-and-scribble.json",

"slug": "augmented-reality",     "title": "Augmented reality",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/augmented-reality",

"title": "Augmented reality",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/augmented-reality",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/augmented-r

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/augmented-reality",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/augmented-reality.json",

"slug": "boxes",     "title": "Boxes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/boxes",

"title": "Boxes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/boxes",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/boxes.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/boxes",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/boxes.json",

"slug": "branding",     "title": "Branding",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/branding",

"title": "Branding",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/branding",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/branding.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/branding",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/branding.json",

"slug": "buttons",     "title": "Buttons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/buttons",

"title": "Buttons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/buttons",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/buttons.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/buttons",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/buttons.json",

"slug": "camera-control",     "title": "Camera Control",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/camera-control",

"title": "Camera Control",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/camera-control",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/camera-control.js

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/camera-control",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/camera-control.json",

"slug": "carekit",     "title": "CareKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/carekit",

"title": "CareKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/carekit",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/carekit.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/carekit",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/carekit.json",

"slug": "carplay",     "title": "CarPlay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/carplay",

"title": "CarPlay",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/carplay",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/carplay.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/carplay",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/carplay.json",

"slug": "charting-data",     "title": "Charting data",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/charting-data",

"title": "Charting data",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/charting-data",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/charting-data.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/charting-data",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/charting-data.json",

"slug": "charts",     "title": "Charts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/charts",

"title": "Charts",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/charts",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/charts.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/charts",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/charts.json",

"slug": "collaboration-and-sharing",     "title": "Collaboration and sharing",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/collaboration-and-sharing",

"title": "Collaboration and sharing",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/collaboration-and-sharing",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidel

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/collaboration-and-sharing",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/collaboration-and-sharing.json",

"slug": "collections",     "title": "Collections",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/collections",

"title": "Collections",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/collections",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/collections.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/collections",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/collections.json",

"slug": "color",     "title": "Color",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/color",

"title": "Color",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/color",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/color.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/color",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/color.json",

"slug": "color-wells",     "title": "Color wells",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/color-wells",

"title": "Color wells",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/color-wells",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/color-wells.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/color-wells",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/color-wells.json",

"slug": "column-views",     "title": "Column views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/column-views",

"title": "Column views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/column-views",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/column-views.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/column-views",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/column-views.json",

"slug": "combo-boxes",     "title": "Combo boxes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/combo-boxes",

"title": "Combo boxes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/combo-boxes",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/combo-boxes.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/combo-boxes",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/combo-boxes.json",

"slug": "complications",     "title": "Complications",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/complications",

"title": "Complications",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/complications",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/complications.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/complications",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/complications.json",

"slug": "components",     "title": "Components",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components",

"title": "Components",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/components.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/components",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/components.json",

"slug": "components/layout-and-organization/tab-views",     "title": "Tab views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/layout-and-organization/tab-views",

"title": "Tab views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/layout-and-organization/tab-views",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-gui

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/layout-and-organization/tab-views",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/components/layout-and-organization/tab-views.json",

"slug": "components/presentation/page-controls",     "title": "Page controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/presentation/page-controls",

"title": "Page controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/presentation/page-controls",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidel

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/presentation/page-controls",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/components/presentation/page-controls.json",

"slug": "components/system-experiences/complications",     "title": "Complications",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/system-experiences/complications",

"title": "Complications",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/system-experiences/complications",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/components/system-experiences/complications",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/components/system-experiences/complications.json",

"slug": "content",     "title": "Content",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/content",

"title": "Content",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/content",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/content.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/content",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/content.json",

"slug": "context-menus",     "title": "Context menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/context-menus",

"title": "Context menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/context-menus",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/context-menus.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/context-menus",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/context-menus.json",

"slug": "controls",     "title": "Controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/controls",

"title": "Controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/controls",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/controls.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/controls",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/controls.json",

"slug": "dark-mode",     "title": "Dark Mode",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/dark-mode",

"title": "Dark Mode",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/dark-mode",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/dark-mode.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/dark-mode",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/dark-mode.json",

"slug": "design-principles",     "title": "Design principles",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/design-principles",

"title": "Design principles",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/design-principles",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/design-prin

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/design-principles",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/design-principles.json",

"slug": "designing-for-games",     "title": "Designing for games",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-games",

"title": "Designing for games",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-games",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designi

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-games",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-games.json",

"slug": "designing-for-ios",     "title": "Designing for iOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ios",

"title": "Designing for iOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ios",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-f

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ios",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-ios.json",

"slug": "designing-for-ipados",     "title": "Designing for iPadOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados",

"title": "Designing for iPadOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/desig

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ipados",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-ipados.json",

"slug": "designing-for-macos",     "title": "Designing for macOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-macos",

"title": "Designing for macOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-macos",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designi

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-macos",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-macos.json",

"slug": "designing-for-tvos",     "title": "Designing for tvOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos",

"title": "Designing for tvOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-tvos",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-tvos.json",

"slug": "designing-for-visionos",     "title": "Designing for visionOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos",

"title": "Designing for visionOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/d

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-visionos.json",

"slug": "designing-for-watchos",     "title": "Designing for watchOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos",

"title": "Designing for watchOS",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/des

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-watchos",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/designing-for-watchos.json",

"slug": "digit-entry-views",     "title": "Digit entry views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/digit-entry-views",

"title": "Digit entry views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/digit-entry-views",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/digit-entry

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/digit-entry-views",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/digit-entry-views.json",

"slug": "digital-crown",     "title": "Digital Crown",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/digital-crown",

"title": "Digital Crown",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/digital-crown",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/digital-crown.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/digital-crown",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/digital-crown.json",

"slug": "disclosure-controls",     "title": "Disclosure controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/disclosure-controls",

"title": "Disclosure controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/disclosure-controls",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/disclos

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/disclosure-controls",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/disclosure-controls.json",

"slug": "dock-menus",     "title": "Dock menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/dock-menus",

"title": "Dock menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/dock-menus",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/dock-menus.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/dock-menus",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/dock-menus.json",

"slug": "drag-and-drop",     "title": "Drag and drop",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/drag-and-drop",

"title": "Drag and drop",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/drag-and-drop",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/drag-and-drop.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/drag-and-drop",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/drag-and-drop.json",

"slug": "edit-menus",     "title": "Edit menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/edit-menus",

"title": "Edit menus",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/edit-menus",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/edit-menus.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/edit-menus",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/edit-menus.json",

"slug": "entering-data",     "title": "Entering data",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/entering-data",

"title": "Entering data",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/entering-data",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/entering-data.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/entering-data",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/entering-data.json",

"slug": "eyes",     "title": "Eyes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/eyes",

"title": "Eyes",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/eyes",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/eyes.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/eyes",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/eyes.json",

"slug": "feedback",     "title": "Feedback",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/feedback",

"title": "Feedback",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/feedback",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/feedback.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/feedback",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/feedback.json",

"slug": "file-management",     "title": "File management",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/file-management",

"title": "File management",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/file-management",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/file-management

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/file-management",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/file-management.json",

"slug": "focus-and-selection",     "title": "Focus and selection",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/focus-and-selection",

"title": "Focus and selection",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/focus-and-selection",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/focus-a

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/focus-and-selection",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/focus-and-selection.json",

"slug": "foundations",     "title": "Foundations",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/foundations",

"title": "Foundations",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/foundations",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/foundations.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/foundations",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/foundations.json",

"slug": "game-center",     "title": "Game Center",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-center",

"title": "Game Center",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-center",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/game-center.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-center",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/game-center.json",

"slug": "game-controls",     "title": "Game controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-controls",

"title": "Game controls",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-controls",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/game-controls.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/game-controls",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/game-controls.json",

"slug": "gauges",     "title": "Gauges",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gauges",

"title": "Gauges",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gauges",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/gauges.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/gauges",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/gauges.json",

"slug": "generative-ai",     "title": "Generative AI",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/generative-ai",

"title": "Generative AI",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/generative-ai",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/generative-ai.json"

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/generative-ai",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/generative-ai.json",

"slug": "gestures",     "title": "Gestures",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gestures",

"title": "Gestures",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gestures",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/gestures.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/gestures",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/gestures.json",

"slug": "getting-started",     "title": "Getting started",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/getting-started",

"title": "Getting started",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/getting-started",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/getting-started

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/getting-started",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/getting-started.json",

"slug": "going-full-screen",     "title": "Going full screen",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/going-full-screen",

"title": "Going full screen",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/going-full-screen",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/going-full-

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/going-full-screen",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/going-full-screen.json",

"slug": "gyro-and-accelerometer",     "title": "Gyroscope and accelerometer",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gyro-and-accelerometer",

"title": "Gyroscope and accelerometer",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/gyro-and-accelerometer",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guideli

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/gyro-and-accelerometer",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/gyro-and-accelerometer.json",

"slug": "healthkit",     "title": "HealthKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/healthkit",

"title": "HealthKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/healthkit",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/healthkit.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/healthkit",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/healthkit.json",

"slug": "home-screen-quick-actions",     "title": "Home Screen quick actions",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/home-screen-quick-actions",

"title": "Home Screen quick actions",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/home-screen-quick-actions",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidel

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/home-screen-quick-actions",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/home-screen-quick-actions.json",

"slug": "homekit",     "title": "HomeKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/homekit",

"title": "HomeKit",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/homekit",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/homekit.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/homekit",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/homekit.json",

"slug": "icloud",     "title": "iCloud",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/icloud",

"title": "iCloud",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/icloud",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icloud.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/icloud",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icloud.json",

"slug": "icons",     "title": "Icons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/icons",

"title": "Icons",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/icons",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icons.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/icons",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/icons.json",

"slug": "id-verifier",     "title": "ID Verifier",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/id-verifier",

"title": "ID Verifier",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/id-verifier",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/id-verifier.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/id-verifier",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/id-verifier.json",

"slug": "image-views",     "title": "Image views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-views",

"title": "Image views",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-views",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/image-views.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-views",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/image-views.json",

"slug": "image-wells",     "title": "Image wells",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-wells",

"title": "Image wells",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-wells",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/image-wells.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/image-wells",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/image-wells.json",

"slug": "images",     "title": "Images",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/images",

"title": "Images",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/images",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/images.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/images",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/images.json",

"slug": "imessage-apps-and-stickers",     "title": "iMessage apps and stickers",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/imessage-apps-and-stickers",

"title": "iMessage apps and stickers",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/imessage-apps-and-stickers",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guid

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/imessage-apps-and-stickers",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/imessage-apps-and-stickers.json",

"slug": "immersive-experiences",     "title": "Immersive experiences",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/immersive-experiences",

"title": "Immersive experiences",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/immersive-experiences",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/imm

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/immersive-experiences",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/immersive-experiences.json",

"slug": "in-app-purchase",     "title": "In-app purchase",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/in-app-purchase",

"title": "In-app purchase",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/in-app-purchase",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/in-app-purchase

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/in-app-purchase",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/in-app-purchase.json",

"slug": "inclusion",     "title": "Inclusion",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/inclusion",

"title": "Inclusion",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/inclusion",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/inclusion.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/inclusion",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/inclusion.json",

"slug": "inputs",     "title": "Inputs",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/inputs",

"title": "Inputs",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/inputs",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/inputs.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/inputs",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/inputs.json",

"slug": "keyboards",     "title": "Keyboards",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/keyboards",

"title": "Keyboards",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/keyboards",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/keyboards.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/keyboards",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/keyboards.json",

"slug": "labels",     "title": "Labels",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/labels",

"title": "Labels",     "apple_url": "https://developer.apple.com/design/human-interface-guidelines/labels",     "json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/labels.json",

"apple_url": "https://developer.apple.com/design/human-interface-guidelines/labels",

"json_endpoint": "https://developer.apple.com/tutorials/data/design/human-interface-guidelines/labels.json",