Does HIG Doctor expose an MCP server?

Yes. The hig-mcp server exposes hig_list_skills, hig_lookup, and hig_audit so MCP-compatible coding agents can list HIG skills, fetch reference topics, and run project audits.

What frameworks can the HIG audit CLI scan?

The audit CLI scans SwiftUI, UIKit, React, Next.js, Vue, Svelte, Angular, React Native, Flutter, Jetpack Compose, Android XML, HTML, and CSS.

How should I design an iPad app using Apple's HIG?

Apple's HIG recommends using sidebars instead of bottom tab bars on iPadOS, supporting split views for multitasking, and adding pointer interactions. Apple HIG Skills provides instant, AI-ready guidance on all iPadOS conventions.

What are Apple's guidelines for adding Apple Pay?

Apple's HIG specifies exact payment button placement, flow design, error states, and UX patterns required for App Store approval. Apple HIG Skills gives your AI agent access to the full Apple Pay design guidelines.

How do I make my Apple app accessible?

Apple's HIG requires support for VoiceOver, Dynamic Type, sufficient color contrast ratios, and motor accessibility features like Switch Control. Apple HIG Skills covers all accessibility foundations and requirements.

How do I design for visionOS and Apple Vision Pro?

Apple's HIG for visionOS covers ornaments, volumes, immersive spaces, eye tracking, and spatial interaction patterns. Apple HIG Skills includes dedicated visionOS platform guidance and spatial layout references.

What are Apple's dark mode design guidelines?

Apple's HIG specifies using system semantic colors, material backgrounds, elevated surfaces, and vibrancy for dark mode. Apps should test in both modes and avoid hard-coded color values. Apple HIG Skills covers the full dark mode specification.

How should I design notifications for iOS apps?

Apple's HIG covers notification grouping, Live Activities, action buttons, and respecting user attention. Apple HIG Skills provides guidelines for the full notification system including widgets and complications.

Typography — Apple HIG Design Guidelines

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.

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

watchOS Dynamic Type sizes

xSmall
Small
Large
xLarge
xxLarge
xxxLarge

SF Pro
SF Pro Rounded
New York

watchOS tracking values

SF Compact
SF Compact Rounded

For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/typography

Typography