apple-design-foundations

Design or review the visual foundations of an Apple-platform interface: layout, typography, color, appearance, materials, motion, icons, imagery, branding, and interface writing.

SKILL.md

GitHub

Apple Visual Design Foundations

Apply the skill

Start from the existing visual system and the content hierarchy. Decide which values should be semantic roles, which belong to the brand, and which must adapt to platform or accessibility settings. Read only the references for the layers being changed.

Prefer system behavior for adaptive typography, color, materials, and controls. Document custom choices in terms of purpose and state, not merely fixed pixels. Separate content surfaces from the navigation and control layer when choosing materials. Do not apply a visual trend uniformly to every surface.

Validate the composition with representative content, large text, light and dark appearances, increased contrast, reduced motion, and relevant window sizes. For an icon or asset deliverable, inspect the current platform specifications and preview the actual small-size and appearance variants before declaring it ready.

Topic references

Select the topic that matches the design decision; do not load this entire list by default.

Source use

These references are original operational summaries of Apple’s public HIG, checked on 2026-09-08. They are guidance for design decisions, not a reproduced manual or a guarantee of App Store acceptance.

Read only the topic references relevant to the current task. Each links to the full official page. Consult that page for exact specifications, platform exceptions, assets, and version-sensitive behavior; use current official developer documentation for APIs and availability. If live documentation is unavailable, state the snapshot date and identify assumptions instead of inventing current requirements.

The user’s product goals, selected framework, and authorized scope remain controlling. Distinguish a source recommendation from a hard platform requirement and from your own proposed implementation.