If you've ever stared at your mockups wondering whether something should be an alert, sheet, or popover, this has the Apple HIG guidance to settle it. It covers when to interrupt users with alerts versus giving them focused tasks in sheets, how to handle destructive actions, and why your confirmation dialogs should say "Delete Photo" instead of "OK". The best part is the output format that includes alternatives, because sometimes the right answer is skipping the modal entirely and making the action undoable. Works across iPhone, iPad, Mac, and visionOS with platform-specific adaptations. Also covers digit entry views if you're building PIN or verification code inputs.

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

Install

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

Installs into .claude/skills of the current project.

Files

Apple HIG: Presentation 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. Alerts: sparingly, for critical situations. Errors needing attention, destructive action confirmations, or information requiring acknowledgment. They interrupt flow and demand a response.

  2. Sheets: focused tasks that maintain context. Slides in from the edge (or attaches to a window on macOS). Use for creating items, editing settings, multi-step forms.

  3. Popovers: non-modal on iPad and Mac. Appear next to the trigger element, dismissed by tapping outside. For additional information, options, or controls without taking over the screen.

  4. Action sheets: choosing among actions. Present when picking from multiple actions, especially if one is destructive. iPhone: slide up from bottom. iPad: appear as popovers.

  5. Minimize interruptions. Before reaching for a modal, consider inline presentation or making the action undoable instead.

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