Skill

Generate Apple HIG Content Components

Apple HIG reference for content components - Charts, Collections, Image Views, Web Views, and Lockups - across iOS, macOS, tvOS, visionOS.


68
Spark score
out of 100
Updated 4 days ago
Version 15.5.1

Add to Favorites

Why it matters

Leverage Apple's Human Interface Guidelines (HIG) to generate code and guidance for content components. This skill ensures your UI elements are adaptable, accessible, and adhere to platform conventions.

Outcomes

What it gets done

01

Recommend appropriate HIG content components based on user needs.

02

Provide configuration guidance and accessibility requirements.

03

Generate code snippets and rationale for selected components.

04

Ensure adherence to platform-specific design conventions.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/ag-hig-components-content | bash

Overview

Apple HIG: Content Components

An Apple HIG reference for choosing content-display components - Charts, Collections, Image/Color Wells, Web Views, Activity Views, Lockups - with accessibility and platform-specific guidance across iOS, macOS, tvOS, watchOS, and visionOS. Use when selecting or configuring a native content-display component for an Apple-platform app, not for layout containers or foundational styling.

What it does

An Apple Human Interface Guidelines reference for choosing and configuring content-display components across iOS, macOS, tvOS, watchOS, and visionOS. Covers eight component types with dedicated reference files: Charts (Swift Charts - bar, line, area, and point marks, chart accessibility, audio graphs), Collections (grid and list layouts, compositional layout, selection, reordering, diffable data sources), Image Views (aspect ratio handling, content modes, SF Symbol images), Image Wells (macOS drag-and-drop image selection), Color Wells (system color picker integration), Web Views (WKWebView versus SFSafariViewController for external browsing), Activity Views (share sheets, custom activities, action extensions), and Lockups (image plus text elements, tvOS card layouts with parallax and focus effects, shelf layouts). Seven key principles guide component selection: adapt to different sizes and contexts via Auto Layout and size classes; make content accessible with audio graph support for charts, alt text for images, and proper VoiceOver navigation order for collections; maintain visual hierarchy through spacing and grouping; prefer system components (UICollectionView, SwiftUI Charts, WKWebView) over custom builds since they come with built-in accessibility and platform adaptation; respect platform conventions, since a collection on tvOS uses large parallax lockups while the same collection on iOS uses compact touch-target cells and on visionOS content gains depth and hover effects; handle empty states with guidance rather than a blank screen; and optimize large datasets with lazy loading, cell reuse, pagination, and prefetching. A component-selection table maps content needs directly to components and their minimum OS versions, for example Charts requiring iOS 16+, macOS 13+, or watchOS 9+, and Color Wells needing macOS or iOS 14+.

When to use - and when NOT to

Use when choosing or configuring a content-display component for an Apple-platform app - visualizing quantitative data, browsing a grid or list, showing a single image or web content, letting a user pick a color or image, sharing to other apps, or building a tvOS content card. Before asking clarifying questions, check for an existing .claude/apple-design-context.md file and only ask about what it doesn't already cover. Not the right skill for structural layout containers such as scroll views, lists, or split views - that's hig-components-layout - or for foundational styling like color and typography, which belongs to hig-foundations.

Inputs and outputs

Input is the content type, target platform or platforms, whether content is static or dynamic, and roughly how much content there is - a few items versus hundreds or thousands, which affects component choice and optimization strategy. Output follows a fixed four-part format: a component recommendation with rationale referencing the relevant HIG file, configuration guidance on key properties, accessibility requirements for that component, and platform-specific notes.

Integrations

Points to eight companion reference files (charts.md, collections.md, image-views.md, image-wells.md, color-wells.md, web-views.md, activity-views.md, lockups.md) and sibling skills hig-foundations, hig-patterns, hig-components-layout, and hig-platforms for adjacent HIG guidance.

Who it's for

iOS, macOS, tvOS, watchOS, or visionOS developers choosing the right native component for displaying content, who need the accessibility requirements and platform-specific behavior differences spelled out rather than re-reading Apple's full HIG.

FAQ

Common questions

Discussion

Questions & comments ยท 0

Sign In Sign in to leave a comment.