Skill

Generate Apple HIG Status Component Code

Apple HIG guidance for status components - progress indicators, status bars, and watchOS activity rings - with platform rules.


72
Spark score
out of 100
Updated yesterday
Version 15.7.0

Add to Favorites

Why it matters

Generate code and guidance for implementing Apple's Human Interface Guidelines (HIG) for status components, including progress indicators and status bars. Ensure adherence to design principles and platform best practices.

Outcomes

What it gets done

01

Provide recommendations for progress indicator types (determinate vs. indeterminate) with rationale.

02

Offer guidance on timing, animation, and transitions for status components.

03

Detail accessibility considerations for VoiceOver and live region updates.

04

Generate platform-specific implementation details.

Install

Add it to your toolbox

Run in your project directory:

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

Overview

Apple HIG: Status Components

Apple HIG guidance for status components - determinate/indeterminate progress indicators, status bar visibility and safe areas, and watchOS activity rings - with color conventions and HealthKit integration requirements. Use when implementing progress feedback, status bar behavior, or watchOS activity tracking on Apple platforms; use companion HIG skills for widgets or gesture-triggered progress.

What it does

Provides Apple Human Interface Guidelines guidance for status components - progress indicators, status bars, and watchOS activity rings - recommending the right indicator type and behavior for a given operation. It first checks for an existing .claude/apple-design-context.md project context file and only asks for information not already covered there.

When to use - and when NOT to

Use when deciding how to show progress for a long-running operation, whether and how to hide the iOS/iPadOS status bar, or how to represent Move/Exercise/Stand activity data on watchOS. Related skills cover adjacent scope: hig-components-system for widgets/complications displaying progress or status, hig-inputs for gestures that trigger progress states like pull-to-refresh, and hig-technologies for the underlying HealthKit and VoiceOver APIs.

Inputs and outputs

Progress indicator principles: show progress for operations longer than a second or two; use a determinate (filling) progress bar when duration or percentage is known, since it feels faster and more trustworthy than a spinner; use an indeterminate spinner only when duration is genuinely unknown, such as unpredictable network requests; place indicators inline near the content area rather than modal or distant; and never stack multiple simultaneous indicators - aggregate them into one representation or show only the most relevant.

Status bar principles: don't hide the status bar without good reason - reserve that for immersive experiences like full-screen media, games, or AR; match status bar style (light/dark) to content for adequate contrast; respect safe areas so no interactive content sits behind the status bar; and restore the status bar promptly when exiting immersive contexts.

Activity ring principles (watchOS): the ring metaphor is reserved for Move, Exercise, and Stand goals and shouldn't be repurposed for unrelated data; ring colors follow strong Apple Fitness conventions (red for Move, green for Exercise, blue for Stand); activity data should come from HealthKit APIs rather than manual tracking; and ring completions should be celebrated with animation and haptics.

Reference files: progress-indicators.md (determinate/indeterminate, inline placement, duration), status-bars.md (system info, visibility, style, safe areas), and activity-rings.md (Move/Exercise/Stand, HealthKit, color conventions).

Output format for each recommendation: indicator type with rationale (determinate vs. indeterminate), timing/animation guidance (duration thresholds, transitions), accessibility notes (VoiceOver progress announcements, live region updates), and platform-specific behavior. Clarifying questions asked when needed: whether duration is known, target platforms, typical operation length, and whether the indicator is system-level or in-app.

Who it's for

iOS/iPadOS/watchOS developers implementing progress feedback, status bar behavior, or fitness activity tracking who need Apple's platform-correct conventions rather than inventing custom status UI.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.