{"id":50928092,"url":"https://github.com/ebuntario/apple-hig","last_synced_at":"2026-06-17T01:04:37.135Z","repository":{"id":352655003,"uuid":"1215990683","full_name":"ebuntario/apple-hig","owner":"ebuntario","description":"Claude Code skill: build Apple-platform UIs that actually follow Apple Human Interface Guidelines across SwiftUI, UIKit, AppKit, iOS, macOS, iPadOS, watchOS, tvOS, and visionOS.","archived":false,"fork":false,"pushed_at":"2026-04-20T14:33:50.000Z","size":91,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T16:37:38.363Z","etag":null,"topics":["appkit","apple","claude-code","claude-skill","design-system","hig","human-interface-guidelines","ios","ipados","macos","swiftui","tvos","uikit","visionos","watchos"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ebuntario.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T13:05:07.000Z","updated_at":"2026-04-20T14:36:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ebuntario/apple-hig","commit_stats":null,"previous_names":["ebuntario/apple-hig"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/ebuntario/apple-hig","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebuntario%2Fapple-hig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebuntario%2Fapple-hig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebuntario%2Fapple-hig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebuntario%2Fapple-hig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ebuntario","download_url":"https://codeload.github.com/ebuntario/apple-hig/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebuntario%2Fapple-hig/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34429503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appkit","apple","claude-code","claude-skill","design-system","hig","human-interface-guidelines","ios","ipados","macos","swiftui","tvos","uikit","visionos","watchos"],"created_at":"2026-06-17T01:04:35.228Z","updated_at":"2026-06-17T01:04:37.128Z","avatar_url":"https://github.com/ebuntario.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# apple-hig\n\nA Claude Code skill that makes Claude actually follow Apple's [Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/) when you're building for iOS, iPadOS, macOS, watchOS, tvOS, or visionOS — instead of producing generic \"Apple-ish\" output.\n\nWorks with **SwiftUI**, **UIKit**, **AppKit**, and web/Figma mockups that need to feel Apple-native.\n\n\u003e Status: **stable · v1.0.0.** Feature-complete across foundations, patterns, components, inputs, platforms, and technologies — 68 reference files, ~15k lines, every one cited to the live HIG. See [`CHANGELOG.md`](./CHANGELOG.md).\n\n## What it does\n\nWhen you mention building something for an Apple platform, this skill kicks in automatically and:\n\n1. **Asks a couple of targeting questions first** (platform, framework, what you're actually building) — so the answer fits your context, not a generic mold.\n2. **Loads only the reference files that matter** for your task — progressive disclosure, no context bloat.\n3. **Applies the non-negotiables** every time: semantic colors, Dynamic Type, SF Symbols, ≥44pt touch targets, VoiceOver labels, Reduce Motion, platform-correct navigation.\n4. **Cites the live HIG** at the top of every reference file so you can verify.\n\n## Install\n\nPaste this into Claude Code:\n\n```bash\ngit clone --single-branch --depth 1 https://github.com/ebuntario/apple-hig.git ~/.claude/skills/apple-hig \u0026\u0026 cd ~/.claude/skills/apple-hig \u0026\u0026 ./setup\n```\n\nThen start a new Claude Code session. Ask about an Apple-platform UI and the skill auto-triggers.\n\n## Update\n\n```bash\ncd ~/.claude/skills/apple-hig \u0026\u0026 git pull\n```\n\n## Uninstall\n\n```bash\n~/.claude/skills/apple-hig/bin/apple-hig-uninstall\n```\n\nOr just `rm -rf ~/.claude/skills/apple-hig`.\n\n## What it covers\n\n| Area | Depth |\n|---|---|\n| iOS / iPhone | Deep |\n| macOS | Deep |\n| iPadOS | Solid |\n| watchOS | Solid |\n| tvOS | Solid |\n| visionOS | Solid |\n| SwiftUI snippets | Primary |\n| UIKit / AppKit snippets | Secondary |\n| Web / Figma native-feel | Notes where relevant |\n\nReference tree mirrors the HIG and covers:\n\n| Area | Files |\n|---|---|\n| `foundations/` — accessibility, typography, color, dark-mode, layout, sf-symbols, materials, motion | 8 |\n| `patterns/` — navigation, modality, settings, search, onboarding, loading, feedback, entering-data, drag-and-drop, managing-accounts, in-app-purchase, managing-notifications, undo-and-redo, file-management, offering-help, multitasking, printing, charting-data, going-full-screen, live-viewing-apps, workouts, ratings-and-reviews | 22 |\n| `components/` — bars, buttons, lists-and-tables, sheets-and-popovers, text-inputs, pickers-and-menus, collections-and-scrolling, segmented-controls, sliders-steppers-toggles, progress-and-activity, labels-and-badges, split-views, system-experiences | 13 |\n| `inputs/` — touch-and-gestures, pointer-and-keyboard, apple-pencil, digital-crown, focus-and-remote, spatial-input, game-controllers | 7 |\n| `platforms/` — ios (deep), macos (deep), ipados, watchos, tvos, visionos | 6 |\n| `technologies/` — widgets-and-live-activities, dynamic-island, control-center, lock-screen, shortcuts-and-siri, app-clips, share-extension, carplay, homekit, imessage-apps, game-center, generative-ai | 12 |\n| `assets/checklists/` — pre-submission-hig-review, accessibility-review, platform-parity-review | 3 |\n\nFull routing index: [`SKILL.md`](./SKILL.md).\n\n## How it differs from similar skill packs\n\n- **No CLAUDE.md injection.** `./setup` does not edit your global config. The skill is discovered by the Claude Code harness on its own. If you want it imported into `CLAUDE.md` explicitly, run `./setup --inject-claudemd`.\n- **Question-first.** The skill asks before generating, because \"an iOS app\" and \"a macOS menu bar app\" need very different answers.\n- **Cited, not invented.** Every reference file starts with the HIG URL it's sourced from. If the HIG is silent on something, the file says so and labels the default.\n\n## Contributing\n\nPRs welcome — especially for:\n- HIG updates after a WWDC release.\n- Missing component/pattern files.\n- Better SwiftUI/UIKit/AppKit snippets.\n\nKeep snippets idiomatic for the current deployment targets listed in each file. Don't paraphrase large blocks of Apple's prose; short quotes + citations only.\n\n## License\n\n[MIT](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febuntario%2Fapple-hig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Febuntario%2Fapple-hig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febuntario%2Fapple-hig/lists"}