HIG Doctor
HIG Doctor is an open-source tool that audits Apple-platform, web, and cross-platform source code against Apple's Human Interface Guidelines and aligned accessibility rules. It helps developers and coding agents find interface issues before release by reporting concerns with severity, location, and fix guidance. It is for developers and teams building Apple-platform or cross-platform apps who want to catch reviewable UI issues early.
✨ Key features
- Audits source against 431 rules across 14 frameworks.
- Reports findings with severity, location, rule ID, and fix guidance.
- Supports gradual adoption with baselines, suppressions, and --fail-on.
- Provides MCP tools for search, lookup, and explanations.
- Offers CLI, MCP server, and embeddable core package.
- Uses structural analysis and regex scanning with precision benchmarks.
🎯 Use cases
- Run a source scan in CI to gate new UI debt.
- Audit a SwiftUI project for deprecated navigation views and hardcoded colors.
- Use MCP tools to search HIG topics and explain findings in an agent workflow.
- Embed the rule engine in custom tooling via the core package.
📦 Installation
🧰 Requirements: Requires Node.js to run via npx or npm; no API keys or accounts mentioned.
npx hig-doctor .
For MCP server: npx -y hig-mcp
For agent skills: /plugin marketplace add raintree-technology/hig-doctor
For core package: npm install @raintree-technology/hig-doctor-core
🚀 Usage
npx hig-doctor .
Example output:
2 moderate concerns · swiftui · 1 file
View.swift:5 · swift/navigation-view-deprecated
View.swift:7 · swift/hardcoded-color
⚠️ Good to know
Automated findings support review but do not prove accessibility, HIG conformance, or design quality; regex fallback can produce different precision than structural analysis.
❓ FAQ
What frameworks does HIG Doctor support?
It supports Apple frameworks (SwiftUI, UIKit, AppKit, watchOS, visionOS) and web/cross-platform frameworks (React, CSS, Vue, Angular, Svelte, Flutter, Jetpack Compose, Android XML, React Native).
How many rules does it have?
The audit catalog currently contains 431 rules across 14 frameworks, with counts generated from the rule catalog and checked in CI.
Can I use HIG Doctor in CI?
Yes, the CLI supports configuration, baselines, SARIF, and --fail-on to gate only new debt.
Is the HIG content in the skills corpus canonical?
No, Apple's live Human Interface Guidelines remain canonical; the snapshot is frozen and human-reviewed, with drift detection nightly.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.