All skills
raintree-technology avatar

/hig-foundations

@5aac106

Apple Human Interface Guidelines design foundations. Use this skill when the user asks about "HIG color", "Apple typography", "SF Symbols", "dark mode guidelines", "accessible design", "Apple design foundations", "app icon", "layout guidelines", "materials", "motion", "privacy", "right to left", "RTL", "inclusive design", branding, images, spatial layout, or writing style. Also use when the user says "my colors look wrong in dark mode", "what font should I use", "is my app accessible enough", "how do I support Dynamic Type", "what contrast ratio do I need", "how do I pick system colors", or "my icons don't match the system style". Cross-references: hig-platforms for platform-specific guidance, hig-patterns for interaction patterns, hig-components-layout for structural components, hig-components-content for display.

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

This session only. Nothing lands on disk.

referencestypography.md

≈743 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/typography. 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.

Typography

Ensuring legibility

Use font sizes that most people can read easily.

Test legibility in different contexts.

In general, avoid light font weights.

Conveying hierarchy

Adjust font weight, size, and color as needed to emphasize important information and help people visualize hierarchy.

Minimize the number of typefaces you use, even in a highly customized interface.

Prioritize important content when responding to text-size changes.

Using system fonts

Consider using the built-in text styles.

Modify the built-in text styles if necessary.

If necessary, adjust tracking in interface mockups.

Using custom fonts

Make sure custom fonts are legible.

Implement accessibility features for custom fonts.

Supporting Dynamic Type

Make sure your app’s layout adapts to all font sizes.

Increase the size of meaningful interface icons as font size increases.

Keep text truncation to a minimum as font size increases.

Consider adjusting your layout at large font sizes.

Maintain a consistent information hierarchy regardless of the current font size.

Platform considerations

macOS

When necessary, use dynamic system font variants to match the text in standard controls.

visionOS

In general, prefer 2D text.

Make sure text looks good and remains legible when people scale it.

Maximize the contrast between text and the background of its container.

If you need to display text that’s not on a background, consider making it bold to improve legibility.

Keep text facing people as much as possible.

Specifications

iOS, iPadOS Dynamic Type sizes

  • xSmall
  • Small
  • Medium
  • Large (default)
  • xLarge
  • xxLarge
  • xxxLarge

iOS, iPadOS larger accessibility type sizes

  • AX1
  • AX2
  • AX3
  • AX4
  • AX5

watchOS Dynamic Type sizes

  • xSmall
  • Small
  • Large
  • xLarge
  • xxLarge
  • xxxLarge

watchOS larger accessibility type sizes

  • AX1
  • AX2
  • AX3

Tracking values

iOS, iPadOS, visionOS tracking values
  • SF Pro
  • SF Pro Rounded
  • New York
watchOS tracking values
  • SF Compact
  • SF Compact Rounded

<!-- 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/typography

Source: SKILL.md on GitHub

No alerts16d4 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill is a documentation resource providing guidance on Apple's Human Interface Guidelines. It contains no executable scripts, code, or external dependencies.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • 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-foundations