hig-components-system

Provide Apple HIG guidance for designing system-experience components across Apple platforms.

102|6|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-components-system-raintree-technology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hig-components-system
Source: https://github.com/raintree-technology/hig-doctor/tree/main/skills/hig-components-system
Command: npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-components-system-raintree-technology

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear, actionable guidance for designing Apple HIG system-experience components across widgets, Live Activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.

Core Features & Use Cases

  • Guidance covers system experiences such as widgets, Live Activities, notifications, complications, Home Screen Quick Actions, Top Shelf, watch faces, App Clips, and App Shortcuts.
  • Offers cross-platform context and interaction patterns for iOS, iPadOS, watchOS, macOS, and visionOS design contexts.
  • Provides cross-reference guidance to align with related system components and integration patterns among hig-components-status, hig-inputs, and hig-technologies.

Quick Start

Apply Apple HIG system-experience guidance to a widget or Live Activity design scenario.

Frequently Asked Questions about hig-components-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design Live Activities that comply with Apple HIG guidelines?

Apple HIG guidelines for Live Activities require selecting appropriate surfaces and interaction patterns across iOS and watchOS. This guidance helps you choose behavior patterns that deliver timely, glanceable information updates to users.

What is the best way to choose widgets vs app clips for iOS interactions?

The best way to choose between widgets and app clips is by evaluating their distinct system-experience roles. Widgets provide glanceable home screen information, while app clips offer lightweight, temporary functionality for immediate tasks without full app installation.

Does this HIG guidance cover complications and watch faces for watchOS?

Yes, this HIG guidance covers complications and watch faces for watchOS. It provides actionable patterns for designing glanceable interactions and selecting appropriate surfaces specifically tailored for Apple Watch system experiences.

How do I apply system-experience design patterns across visionOS and macOS?

To apply system-experience design patterns across visionOS and macOS, use the provided cross-platform context to align interactions. This ensures your notifications and widgets adapt their behavior patterns appropriately to each operating system's unique environment.

When should I use Home Screen Quick Actions and Top Shelf in my app?

You should use Home Screen Quick Actions and Top Shelf when you need to provide fast access to app shortcuts and media content. Apple HIG guidance helps define these interaction patterns to ensure seamless integration with system experiences.

Can I cross-reference HIG system components with status and input guidelines?

Yes, you can cross-reference HIG system components with status and input guidelines. The guidance provides integration patterns to align your widgets and notifications with related components like hig-components-status and hig-inputs for cohesive app design.