All skills
raintree-technology avatar

/hig-components-status

@5aac106

Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use this skill when asked about: "progress indicator", "progress bar", "loading spinner", "status bar", "activity ring", "progress display", determinate vs indeterminate progress, loading states, or fitness tracking rings. Also use when the user says "how do I show loading state," "should I use a spinner or progress bar," "what goes in the status bar," or asks about activity indicators. Cross-references: hig-components-system for widgets and complications, hig-inputs for gesture-driven progress controls, hig-technologies for HealthKit and activity ring data integration.

Use this Skill: https://skilld.dev/gh/raintree-technology/hig-doctor/hig-components-status

This session only. Nothing lands on disk.

referencesactivity-rings.md

≈640 tokens on demand. Your agent reads this file only when SKILL.md points to it.

<!-- hig-doctor:attribution -->

Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/activity-rings. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

Activity rings

Best practices

Display Activity rings when they’re relevant to the purpose of your app.

Use Activity rings only to show Move, Exercise, and Stand information.

Use Activity rings to show progress for a single person.

Always keep the visual appearance of Activity rings the same, regardless of where you display them.

  • Never change the colors of the rings; for example, don’t use filters or modify opacity.

  • Always display Activity rings on a black background.

  • Prefer enclosing the rings and background within a circle. To do this, adjust the corner radius of the enclosing view rather than applying a circular mask.

  • Ensure that the black background remains visible around the outermost ring. If necessary, add a thin, black stroke around the outer edge of the ring, and avoid including a gradient, shadow, or any other visual effect.

  • Always scale the rings appropriately so they don’t seem disconnected or out of place.

  • When necessary, design the surrounding interface to blend with the rings; never change the rings to blend with the surrounding interface.

To display a label or value that’s directly associated with an Activity ring, use the colors that match it.

Maintain Activity ring margins.

Differentiate other ring-like elements from Activity rings.

Don’t send notifications that repeat the same information the Activity app sends.

Don’t use Activity rings for decoration.

Don’t use Activity rings for branding.

Platform considerations

iOS

  • With an Apple Watch paired, iOS shows all three Activity rings.

  • Without an Apple Watch paired, iOS shows the Move ring only, which represents an approximation of a person’s activity based on their steps and workout information from other apps.


<!-- hig-doctor:canonical-footer -->

For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/activity-rings

Source: SKILL.md on GitHub

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides design guidance based on the Apple Human Interface Guidelines for status and progress components. It is a documentation-only skill containing no executable code, network operations, or security risks.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    2/4 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 5aac106. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 weeks ago.

Activeupdated 7 months ago
version
1.0.0

README badge

README badge for raintree-technology/hig-doctor/hig-components-status