A complete, on-disk copy of Apple's Human Interface Guidelines — so your assistant builds and audits interfaces to spec across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS — and brings the same principles and tokens to web apps and cross-platform desktop software. Runs from any AI coding tool, on macOS or Windows. No runtime fetching; it loads only what each task needs.
# in a Claude Code session
/plugin marketplace add elevatormusic/apple-hig
/plugin install apple-hig@apple-hig
The same flight tracker, built two ways — live, not screenshots. Tap the buttons in either to feel the difference: vanilla Claude Code on the left, the same app after apple-hig reviews it on the right. (A from-scratch build runs lower down.)
Skytrace — the flight tracker designed to Apple's HIG with the plugin — embedded and live. Switch your system between light and dark; the Liquid Glass chrome, semantic colors, and type all adapt.
The demo maps above are token-free vector maps — the right call for a public, forkable
demo. When an app needs genuine Apple Maps, the plugin scaffolds a HIG-correct
MapKit JS integration for the web (and a SwiftUI Map for native),
grounded in its Maps reference.
// MapKit JS 6 — a domain-bound token from MAPKIT_TOKEN; no private key in the client import { load } from "@apple/mapkit-loader"; const mapkit = await load({ libraries: ["map", "annotations"], token: process.env.MAPKIT_TOKEN }); const map = new mapkit.Map("map", { // match the system appearance (light / dark) colorScheme: matchMedia("(prefers-color-scheme: dark)").matches ? mapkit.Map.ColorSchemes.Dark : mapkit.Map.ColorSchemes.Light, // standard controls, not custom chrome showsUserLocationControl: true, showsCompass: mapkit.FeatureVisibility.Adaptive, }); // Apple's logo + Legal link stay visible · Reduce Motion → no camera fly-in map.setRegionAnimated(region, !matchMedia("(prefers-reduced-motion: reduce)").matches);
Generated by /hig-scaffold — bring your own
domain-bound token; nothing is committed to the repo.
A router skill, an auditing subagent, and design-token output — over 161 sourced reference files.
Triggers on any UI/design/review task, detects the platform, and loads just the few relevant guideline files — never the whole folder.
Audits SwiftUI, UIKit, AppKit, React, Flutter, or CSS — and when it can render the screen it measures contrast, target size, visual-weight hierarchy, and how it holds up under large text, reflow, and RTL. Judges web, macOS, and desktop software by their own rules, never forced iOS chrome — and measures native JUCE/C++ apps via a drop-in design probe.
/hig-review audits code, /hig-scaffold generates a compliant screen, /hig-tokens emits tokens as CSS, Tailwind, JSON, SwiftUI, or React Native, and /hig-sync pulls live Apple tokens from a local Xcode SDK (macOS).
The type ramp, system colors and their dark variants, device sizes, 44/60 pt targets, and contrast minimums — checked against Apple's live HIG.
Reflects the “26” generation and the WWDC 2026 “Golden Gate” (27) refinement, with a source URL on every file for re-verification.
The whole reference ships in the plugin and loads on demand — fast, offline, and stable. About 480 always-on tokens per session.
Native to Apple's platforms — and the same HIG principles and tokens carry to web apps (React, Vue, plain HTML/CSS) and cross-platform desktop software, adapting to the host platform instead of forcing iOS chrome. The Skytrace demo above is itself a web app.
Native plugin for Claude Code. One command writes the right rules file for everything else.
# in your project — pick your tool (or --tool all)
npx github:elevatormusic/apple-hig --tool cursor
In Claude Code, install the native plugin. Elsewhere, run the one-liner above.
/plugin marketplace add elevatormusic/apple-hig (or claude plugin marketplace add elevatormusic/apple-hig from a terminal)./plugin install apple-hig@apple-hig./hig-review on a file./plugin install playwright@claude-plugins-official) so the reviewer can render and visually verify your UI — real contrast, spacing, and dark mode.