Covers Apple's HIG guidance on progress indicators, status bars, and activity rings. The skill walks you through when to use determinate versus indeterminate progress, where to place loading states, and when to hide the status bar without annoying users. It's organized around the principles that matter: show progress for anything longer than a second or two, prefer progress bars over spinners when you know the duration, and don't repurpose activity rings for non-fitness data. The reference docs break down progress indicators, status bar behavior, and watchOS activity rings separately. Useful if you're building anything with loading states or fitness tracking and want to follow platform conventions instead of guessing.

skills.sh installs
204
GitHub stars
61
last updated
Jun 3, 2026

Install

$ npx -y skills add raintree-technology/apple-hig-skills --skill hig-components-status --agent claude-code

Installs into .claude/skills of the current project.

Files

Apple HIG: Status Components

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Key Principles

  1. Show progress for operations longer than a second or two.

  2. Determinate when duration/percentage is known. A filling progress bar gives users a clear sense of remaining work. Use for downloads, uploads, or any measurable process.

  3. Indeterminate when duration is unknown. A spinner communicates work is happening without promising a timeframe. Use for unpredictable network requests.

  4. Prefer progress bars over spinners. Determinate progress feels faster and more trustworthy.

  5. Place indicators where content will appear. Inline progress near the content area, not modal or distant.

  6. Don't stack multiple indicators. Aggregate simultaneous operations into one representation or show the most relevant.

  7. Don't hide the status bar without good reason. Reserve hiding for immersive experiences (full-screen media, games, AR).

  8. Match status bar style to your content. Light or dark for adequate contrast.

Sponsors

Details

Repository
github.com/raintree-technology/apple-hig-skills
First seen
Jun 3, 2026

More from raintree-technology/apple-hig-skills

All 14

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs