This covers all the ways your app shows up outside itself: widgets, Live Activities, notifications, complications, App Clips, and the rest of Apple's system surfaces. It's comprehensive HIG guidance with cross-references and specific constraints for each format. Use it when you're designing a widget family or figuring out whether to build an App Clip versus a full download. The structure is solid with a reference index, output format template, and questions to guide the design conversation. What stands out is the practical framing around glanceability, update budgets, and deep linking, which are the things that actually trip people up when moving from in-app to system-level experiences.

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

Install

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

Installs into .claude/skills of the current project.

Files

Apple HIG: System Experiences

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

Key Principles

  1. Glanceable, immediate value. System experiences bring your app's most important content to surfaces the user sees without launching your app. Design for seconds of attention.

  2. Respect platform context. A Lock Screen widget has different constraints than a Home Screen widget. A complication is far smaller than a top shelf item.

  3. Widgets: show relevant information, not everything. Display the most useful subset, updated appropriately.

  4. Support multiple widget sizes with distinct layouts. Each size should be a thoughtful design, not a scaled version of another.

  5. Deep-link on tap. Take users to the relevant content, not the app's root screen.

  6. Live Activities: track events with a clear start and end. Deliveries, scores, timers, rides. Design for both Dynamic Island and Lock Screen.

  7. Stay updated and timely. Stale data undermines trust. End promptly when the event concludes.

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