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?

HIG Doctor includes iPadOS references for sidebars, tab bars, split views, multitasking, and pointer interactions. Use those references to inform a design, then verify consequential decisions against Apple's current documentation.

What are Apple's guidelines for adding Apple Pay?

HIG Doctor includes Apple Pay references for button presentation, checkout flow, and failure states. Verify the finished experience against Apple's current design and review requirements.

How do I make my Apple app accessible?

HIG Doctor includes accessibility references for VoiceOver, Dynamic Type, color and contrast, and motor accessibility. Automated guidance does not replace accessibility testing or review of Apple's current 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. HIG Doctor includes dedicated visionOS platform guidance and spatial layout references.

What are Apple's dark mode design guidelines?

HIG Doctor includes dark mode references for semantic colors, materials, elevated surfaces, and vibrancy. Test each supported appearance and verify the design against Apple's current documentation.

How should I design notifications for iOS apps?

HIG Doctor includes references for notifications, Live Activities, actions, widgets, and complications. Select the topics that apply to the product and platform.

Give your AI structured
Apple design guidance

HIG Doctor organizes Apple Human Interface Guidelines references for AI-assisted design and development.

Retrieve attributed guidance for iOS, iPadOS, macOS, watchOS, and visionOS. Verify consequential decisions against Apple's current documentation.

Install HIG Doctor See it in action

Star on GitHub140|Product Hunt|14 skills. 156 HIG reference topics.

npx skills add raintree-technology/hig-doctor

Claude Code

Review interface code in your browser

Paste a component or choose a sample. Run 431 local checks, review the prioritized findings, and re-run the audit after each change.

Sample to review

·React / Next.js

Design review

Select Run audit to see prioritized findings. The browser runs this audit locally.

Uses the shared browser-compatible rules from the bun run audit CLI and the hig_audit MCP tool. TypeScript AST checks remain available in the CLI and MCP audit.

Find guidance for a design decision

Ask about a platform, component, input method, pattern, or Apple technology. HIG Doctor retrieves relevant references and source links.

Building an iPad app?

Retrieve iPadOS references for sidebars, tab bars, split views, multitasking, and pointer interactions.

Platforms

Layout

Inputs

Adding Apple Pay?

Review button presentation, checkout flow, and failure-state guidance, then verify the finished experience against Apple's current requirements.

Technologies

Patterns

Designing for visionOS?

Retrieve visionOS references for ornaments, volumes, immersive spaces, eye tracking, and spatial interactions.

Platforms

Inputs

Layout

Getting dark mode right?

Find guidance for system colors, materials, elevation, and vibrancy, then test the finished interface in every supported appearance.

Foundations

Content

See it in action

See the difference

Compare an illustrative generic response with an answer that uses HIG Doctor references. Verify both against Apple's current documentation.

“How should I handle navigation in my iPad app?”

Generic example

Based on common iOS patterns, you should

use a UITabBarController with bottom tabs

for your main navigation. Add 3-5 tabs for

your key sections. You can also add a

hamburger menu for additional options.

Applies iOS phone patterns to iPad
Suggests hamburger menus (Apple discourages these)
No mention of iPadOS-specific conventions

HIG-informed example

Per Apple's HIG for iPadOS, use a sidebar

instead of a bottom tab bar. iPadOS has more

screen space, so a sidebar gives users

persistent, scannable navigation.

Use a split view with a two- or three-column

layout. The sidebar should collapse on compact

widths and support iPad multitasking.

Knows iPadOS uses sidebars, not tab bars
References split views and multitasking
Cites the specific HIG topic

Install HIG Doctor

Your agent loads only what it needs

HIG Doctor uses progressive disclosure. Your agent reads a short index first, then loads the selected skill and relevant reference topics.

Full corpus

All reference topics

→

Selected references

Relevant to the question

Focused

Less unrelated context

Focused

Loads selected topics

Attributed

Links to Apple sources

Versioned

Updates through releases

Step 1
14 descriptions
Discovery
Your agent reads 14 skill descriptions and selects the skill that best matches the question.
Step 2
1 selected skill
Activation
The selected skill loads its principles and reference index to identify relevant topics.
Step 3
Project details
Context
When project context is available, the agent applies your platform, technology, and constraints.
Step 4
Relevant topics
Reference
The agent loads the reference topics that apply to the question and can follow their Apple source links.

See what's included

Built for how you work

Use the same structured HIG reference set across individual and team workflows.

Indie iOS developers

Retrieve relevant HIG references without leaving your AI-assisted development workflow.

Design teams

Give supported AI tools the same structured reference set so team members can start from consistent source material.

Agencies and consultancies

Use attributed HIG references during client reviews, then verify recommendations against Apple's current documentation.

Teams building AI features

Use platform-specific references when reviewing AI-generated interfaces before release.

What's included

14 skills organize 156 HIG reference topics for AI-assisted retrieval.

New here? Start with to record your platform, technology, and constraints. Then open for platform-specific guidance. Other skills load when a question needs them.

Skill	Category	Description	References
Project Context	Setup	Creates a shared design context document so other HIG skills can tailor guidance to your app without repetitive questions.	—
Platforms7 refs	Platforms	Platform-specific design guidance for iOS, iPadOS, macOS, tvOS, visionOS, watchOS, and games.	7 refs
Foundations18 refs	Foundations	Visual design foundations including color, typography, layout, icons, materials, motion, accessibility, and more.	18 refs
Patterns25 refs	Patterns	UX patterns for onboarding, navigation, modality, feedback, drag-and-drop, searching, settings, and more.	25 refs
Content8 refs	Components	Content display components: charts, collections, image views, web views, and more.	8 refs
Layout12 refs	Components	Layout and organization: sidebars, split views, tab bars, windows, lists, and more.	12 refs
Menus & Actions11 refs	Components	Menus and actions: buttons, context menus, toolbars, menu bar, pop-up buttons, and more.	11 refs
Search3 refs	Components	Search and navigation: search fields, page controls, path controls.	3 refs
Dialogs5 refs	Components	Dialogs and overlays: alerts, action sheets, sheets, popovers, digit entry views.	5 refs
Controls14 refs	Components	Input controls: pickers, toggles, sliders, text fields, segmented controls, and more.	14 refs
Status3 refs	Components	Status and progress: progress indicators, status bars, activity rings.	3 refs
System9 refs	Components	System experiences: widgets, Live Activities, notifications, App Clips, complications, and more.	9 refs
Inputs13 refs	Inputs	Input methods: gestures, keyboards, Apple Pencil, pointers, game controllers, Digital Crown, and more.	13 refs
Technologies28 refs	Technologies	Apple technology integrations: Siri, Apple Pay, HealthKit, ARKit, Sign in with Apple, and more.	28 refs

Prefer reading in the browser? Browse all 156 HIG topics

Open Standard

Portable files with explicit updates

HIG Doctor uses the Agent Skills format for reusable guidance. Use the files with supported tools, and run an update command when HIG Doctor publishes a new release.

Learn about Agent Skills

Portable

Use the same skill files with the supported tools listed below. Loading behavior depends on each tool's Agent Skills support.

Versionable

Run git pull after HIG Doctor publishes an update. Review the release notes before adopting changed guidance.

Universal

Store reusable guidance as Agent Skills instead of duplicating the same reference content in tool-specific instruction files.

Supported tools and agents