Skip to content
Back to search

apple-hig-designer

SkillWorks with Claude CodeGitHub

Design Apple-style iOS/macOS interfaces following Human Interface Guidelines. Creates HIG-compliant components with SF Symbols, San Francisco typography, and proper accessibility. Supports optional modern effects. Use when designing Apple-style UI, iOS/macOS interfaces, HIG-compliant components, or implementing design system specifications.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/axiaoge2-apple-hig-designer/badge.svg)](/listings/axiaoge2-apple-hig-designer)

HTML

<a href="/listings/axiaoge2-apple-hig-designer"><img src="/api/listings/axiaoge2-apple-hig-designer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Method 1: User-level Installation (Recommended)

Copy the skill to your Claude Code skills directory:

# Windows
xcopy /E /I "apple-hig-designer" "%USERPROFILE%\.claude\skills\apple-hig-designer"

# macOS / Linux
cp -r apple-hig-designer ~/.claude/skills/

Method 2: Project-level Installation

Copy to your project's `.claude/skills` directory:

mkdir -p .claude/skills
cp -r apple-hig-designer .claude/skills/

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 445 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: apple-hig-designer
  3. description: Design Apple-style iOS/macOS interfaces following Human Interface Guidelines. Creates HIG-compliant components with SF Symbols, San Francisco typography, and proper accessibility. Supports optional modern effects. Use when designing Apple-style UI, iOS/macOS interfaces, HIG-compliant components, or implementing design system specifications.
  4. ---
  5. # Apple HIG Designer
  6. A professional-grade frontend design skill that enables Claude Code to create interfaces following Apple's Human Interface Guidelines (HIG), achieving the quality standards of Apple's design team.
  7. ## When to Use This Skill
  8. Activate this skill when users request:
  9. - Apple-style or iOS/macOS-style interfaces
  10. - HIG-compliant UI components
  11. - SF Symbols integration
  12. - San Francisco typography implementation
  13. - Modern glass effects (optional, user must explicitly request)
  14. **Trigger phrases:**
  15. - "Design an Apple-style..."
  16. - "Create a HIG-compliant..."
  17. - "iOS/macOS style component"
  18. - "苹果风格的界面"
  19. - "符合 HIG 的设计"
  20. ---
  21. ## Core Design Principles
  22. ### The Four Pillars of Apple Design
  23. 1. **Clarity (清晰)**
  24. - Every element has a purpose
  25. - Eliminate unnecessary complexity
  26. - Users understand immediately without instructions
  27. - Use clear visual hierarchy
  28. 2. **Deference (尊重内容)**
  29. - UI elements support, not compete with content
  30. - Minimize chrome and visual noise
  31. - Let content be the hero
  32. - Use subtle backgrounds and borders
  33. 3. **Depth (层次)**
  34. - Create clear visual hierarchy through layers
  35. - Use shadows, blur, and translucency purposefully
  36. - Motion reinforces spatial relationships
  37. - Z-axis communicates importance
  38. 4. **Consistency (一致性)**
  39. - Familiar patterns across platforms
  40. - Predictable interactions
  41. - Unified visual language
  42. - Respect platform conventions
  43. ---
  44. ## Design System Specifications
  45. ### Typography System
  46. **Font Family:** San Francisco (SF Pro)
  47. ```css
  48. /* System Font Stack for Web */
  49. :root {
  50. --font-system: -apple-system, BlinkMacSystemFont, 'SF Pro Display',
  51. 'SF Pro Text', 'Helvetica Neue', Arial, sans-serif;
  52. --font-mono: 'SF Mono', SFMono-Regular, Menlo, Monaco, monospace;
  53. }
  54. /* Font Size Scale (iOS) */
  55. --text-caption2: 11px; /* Caption 2 */
  56. --text-caption1: 12px; /* Caption 1 */
  57. --text-footnote: 13px; /* Footnote */
  58. --text-subhead: 15px; /* Subheadline */
  59. --text-body: 17px; /* Body - Default */
  60. --text-headline: 17px; /* Headline (semibold) */
  61. --text-title3: 20px; /* Title 3 */
  62. --text-title2: 22px; /* Title 2 */
  63. --text-title1: 28px; /* Title 1 */
  64. --text-large-title: 34px; /* Large Title */
  65. ```
  66. **Typography Rules:**
  67. - Use SF Pro Display for sizes ≥ 20pt
  68. - Use SF Pro Text for sizes < 20pt
  69. - Maintain consistent line-height (1.2-1.5)
  70. - Use weight for hierarchy, not just size
  71. ### Color System
  72. ```css
  73. /* Apple System Colors - Light Mode */
  74. :root {
  75. /* Primary Colors */
  76. --system-blue: #007AFF;
  77. --system-green: #34C759;
  78. --system-indigo: #5856D6;
  79. --system-orange: #FF9500;
  80. --system-pink: #FF2D55;
  81. --system-purple: #AF52DE;
  82. --system-red: #FF3B30;
  83. --system-teal: #5AC8FA;
  84. --system-yellow: #FFCC00;
  85. /* Gray Scale */
  86. --system-gray: #8E8E93;
  87. --system-gray2: #AEAEB2;
  88. --system-gray3: #C7C7CC;
  89. --system-gray4: #D1D1D6;
  90. --system-gray5: #E5E5EA;
  91. --system-gray6: #F2F2F7;
  92. /* Semantic Colors */
  93. --label-primary: #000000;
  94. --label-secondary: rgba(60, 60, 67, 0.6);
  95. --label-tertiary: rgba(60, 60, 67, 0.3);
  96. --label-quaternary: rgba(60, 60, 67, 0.18);
  97. /* Backgrounds */
  98. --bg-primary: #FFFFFF;
  99. --bg-secondary: #F2F2F7;
  100. --bg-tertiary: #FFFFFF;
  101. /* Separators */
  102. --separator: rgba(60, 60, 67, 0.29);
  103. --separator-opaque: #C6C6C8;
  104. }
  105. /* Dark Mode */
  106. @media (prefers-color-scheme: dark) {
  107. :root {
  108. --system-blue: #0A84FF;
  109. --system-green: #30D158;
  110. --system-indigo: #5E5CE6;
  111. --system-orange: #FF9F0A;
  112. --system-pink: #FF375F;
  113. --system-purple: #BF5AF2;
  114. --system-red: #FF453A;
  115. --system-teal: #64D2FF;
  116. --system-yellow: #FFD60A;
  117. --system-gray: #8E8E93;
  118. --system-gray2: #636366;
  119. --system-gray3: #48484A;
  120. --system-gray4: #3A3A3C;
  121. --system-gray5: #2C2C2E;
  122. --system-gray6: #1C1C1E;
  123. --label-primary: #FFFFFF;
  124. --label-secondary: rgba(235, 235, 245, 0.6);
  125. --label-tertiary: rgba(235, 235, 245, 0.3);
  126. --label-quaternary: rgba(235, 235, 245, 0.18);
  127. --bg-primary: #000000;
  128. --bg-secondary: #1C1C1E;
  129. --bg-tertiary: #2C2C2E;
  130. --separator: rgba(84, 84, 88, 0.6);
  131. --separator-opaque: #38383A;
  132. }
  133. }
  134. ```
  135. ### Spacing System
  136. **8pt Grid System:**
  137. ```css
  138. :root {
  139. --space-1: 4px; /* Extra small */
  140. --space-2: 8px; /* Small */
  141. --space-3: 12px; /* Medium-small */
  142. --space-4: 16px; /* Medium */
  143. --space-5: 20px; /* Medium-large */
  144. --space-6: 24px; /* Large */
  145. --space-8: 32px; /* Extra large */
  146. --space-10: 40px; /* 2X large */
  147. --space-12: 48px; /* 3X large */
  148. }
  149. ```
  150. **Touch Target Requirements:**
  151. - **iOS:** Minimum 44×44 points
  152. - **visionOS:** Minimum 60 points tap area
  153. - Always add sufficient padding for small visual elements
  154. ### Border Radius (Concentric Design)
  155. ```css
  156. :root {
  157. /* Base radius values */
  158. --radius-sm: 8px;
  159. --radius-md: 12px;
  160. --radius-lg: 16px;
  161. --radius-xl: 20px;
  162. --radius-2xl: 24px;
  163. --radius-full: 9999px; /* Capsule */
  164. }
  165. /* Concentric Rule: inner_radius + padding = outer_radius */
  166. /* Example: 8px inner + 8px padding = 16px outer */
  167. ```
  168. ---
  169. ## Component Patterns
  170. The following components should follow Apple HIG conventions. For complete CSS implementations, see [resources/design-tokens.css](resources/design-tokens.css) and [resources/ui-patterns.md](resources/ui-patterns.md). For React component examples, see [resources/components.jsx](resources/components.jsx).
  171. ### Buttons
  172. - **Primary:** Capsule shape (`border-radius: 9999px`), `min-height: 44px`, system-blue background, white text, 600 weight
  173. - **Secondary:** Same capsule shape, system-blue text on `rgba(0, 122, 255, 0.1)` background
  174. - **Press feedback:** `scale(0.98)` on `:active`
  175. ### Glass Effect (Optional - Only When Requested)
  176. - **Only use when user explicitly requests** glass/frosted effects
  177. - Default designs should use solid backgrounds for readability and performance
  178. - `backdrop-filter: blur(20px) saturate(180%)` with semi-transparent background
  179. - Always provide non-glass fallback
  180. ### Cards
  181. - **Default:** Solid background (`--bg-tertiary`), `border-radius: 16px`, subtle box-shadow
  182. - **Grouped style:** `--bg-secondary` outer with `--bg-tertiary` inner items, separated by `--separator`
  183. ### Input Fields
  184. - `min-height: 44px`, `--bg-secondary` background, `border-radius: 12px`
  185. - Focus state: `box-shadow: 0 0 0 4px rgba(0, 122, 255, 0.3)`
  186. ### Tab Bars
  187. - Position fixed at bottom, `height: 49px` + safe-area padding
  188. - Minimum 44x44pt touch targets per tab
  189. - Always display text labels (never icon-only)
  190. - Use filled SF Symbols for selected state, outline for unselected
  191. - Support badge for notifications (red oval, white text)
  192. ### Toolbars
  193. - Three sections: leading (back/title), center (tools), trailing (actions)
  194. - Maximum 3 item groups
  195. - Use SF Symbols without borders
  196. - Primary action uses `.prominent` style on trailing side
  197. - Back button: circular with symbol only (no text)
  198. ### Sheets
  199. - Detents: `large` (100%), `medium` (50%)
  200. - Include grabber indicator (36x5px, centered)
  201. - Done button: top-right; Cancel button: top-left
  202. - Semi-transparent backdrop `rgba(0,0,0,0.4)`
  203. ### Alerts
  204. - Use only for critical information (sparingly)
  205. - Maximum 3 buttons; use specific verb titles, avoid "OK"
  206. - Cancel: leading side; Destructive: only for unintended destructive actions
  207. - Width: 270px, `border-radius: 14px`
  208. ### Lists and Tables
  209. - Minimum row height: 44px
  210. - Info button: reveals details without navigation
  211. - Disclosure indicator (>): navigates to subview
  212. - Grouped style: 10px border-radius, inset separators start at 60px
  213. ---
  214. ## Animation Guidelines
  215. ### Timing Functions
  216. ```css
  217. :root {
  218. /* Apple's preferred easing */
  219. --ease-default: cubic-bezier(0.25, 0.1, 0.25, 1);
  220. --ease-in: cubic-bezier(0.42, 0, 1, 1);
  221. --ease-out: cubic-bezier(0, 0, 0.58, 1);
  222. --ease-in-out: cubic-bezier(0.42, 0, 0.58, 1);
  223. /* Spring-like easing */
  224. --ease-spring: cubic-bezier(0.175, 0.885, 0.32, 1.275);
  225. }
  226. ```
  227. ### Duration Scale
  228. ```css
  229. :root {
  230. --duration-instant: 100ms; /* Micro-interactions */
  231. --duration-fast: 200ms; /* Hover, focus states */
  232. --duration-normal: 300ms; /* Standard transitions */
  233. --duration-slow: 500ms; /* Complex animations */
  234. }
  235. ```
  236. ### Interaction Feedback
  237. ```css
  238. /* Press feedback */
  239. .interactive {
  240. transition: transform var(--duration-instant) var(--ease-out);
  241. }
  242. .interactive:active {
  243. transform: scale(0.97);
  244. }
  245. /* Hover glow */
  246. .interactive:hover {
  247. box-shadow: 0 0 0 4px rgba(0, 122, 255, 0.15);
  248. }
  249. ```
  250. ---
  251. ## SF Symbols Integration
  252. ### Rendering Modes
  253. 1. **Monochrome:** Single color for all layers
  254. 2. **Hierarchical:** Opacity variations for depth
  255. 3. **Palette:** Custom colors per layer
  256. 4. **Multicolor:** Apple's intrinsic symbol colors
  257. ### Usage Guidelines
  258. - **Toolbar/Navigation:** Use outline variant
  259. - **Tab Bar:** Use fill variant
  260. - **Match text size:** Symbols auto-align with SF font
  261. - **Provide text alternatives:** Always include aria-label
  262. ### Web Implementation (Icon Font Alternative)
  263. ```html
  264. <!-- Using SF Symbols via system font -->
  265. <span class="sf-symbol" aria-label="Settings">􀣋</span>
  266. <!-- Or use equivalent system icons -->
  267. <svg class="icon" aria-hidden="true">
  268. <use href="#icon-gear"></use>
  269. </svg>
  270. ```
  271. ---
  272. ## Accessibility Requirements
  273. ### Color Contrast
  274. - **Normal text:** 4.5:1 minimum (WCAG AA)
  275. - **Large text:** 3:1 minimum
  276. - **Interactive elements:** Clearly distinguishable states
  277. ### Motion
  278. ```css
  279. @media (prefers-reduced-motion: reduce) {
  280. * {
  281. animation-duration: 0.01ms !important;
  282. transition-duration: 0.01ms !important;
  283. }
  284. }
  285. ```
  286. ### Semantic HTML
  287. ```html
  288. <!-- Always use semantic elements -->
  289. <button type="button">Action</button>
  290. <nav aria-label="Main navigation">...</nav>
  291. <main role="main">...</main>
  292. ```
  293. ---
  294. ## Output Format
  295. When generating Apple-style UI code, always include:
  296. 1. **Complete, runnable code** (CSS/React/Vue)
  297. 2. **Light/Dark mode support** via CSS custom properties
  298. 3. **Design rationale** explaining HIG compliance
  299. 4. **Responsive breakpoints** for different devices
  300. 5. **Accessibility attributes** (aria-*, role, etc.)
  301. ### Default Behavior
  302. - **Use solid backgrounds by default** for better readability
  303. - **Glass/blur effects only when user explicitly requests**
  304. - **Always provide non-glass fallback** for browsers without backdrop-filter support
  305. ### Example Output Structure
  306. ```jsx
  307. /**
  308. * Apple HIG Compliant Component
  309. *
  310. * Design Decisions:
  311. * - Uses SF Pro system font stack for native feel
  312. * - 44pt minimum touch target for accessibility
  313. * - Capsule shape for primary actions (HIG recommendation)
  314. * - Solid background for optimal readability
  315. * - Supports prefers-color-scheme for auto theming
  316. */
  317. const AppleButton = ({ children, variant = 'primary', ...props }) => {
  318. return (
  319. <button
  320. className={`btn btn-${variant}`}
  321. {...props}
  322. >
  323. {children}
  324. </button>
  325. );
  326. };
  327. ```
  328. ---
  329. ## Best Practices Checklist
  330. Before finalizing any design output, verify:
  331. - [ ] **Typography:** Using SF Pro with correct size thresholds
  332. - [ ] **Colors:** System colors with Light/Dark variants
  333. - [ ] **Spacing:** Following 8pt grid
  334. - [ ] **Touch targets:** Minimum 44×44pt
  335. - [ ] **Border radius:** Concentric relationships maintained
  336. - [ ] **Animations:** Using Apple-standard easing curves
  337. - [ ] **Accessibility:** WCAG AA compliant, reduced motion support
  338. - [ ] **Consistency:** Matches platform conventions
  339. - [ ] **Backgrounds:** Solid by default, glass only when requested
  340. ---
  341. ## Additional Resources
  342. ### Local References (read these for detailed implementations)
  343. - For complete design patterns and real-world examples, see [REFERENCE.md](REFERENCE.md)
  344. - For CSS custom properties and design tokens, see [resources/design-tokens.css](resources/design-tokens.css)
  345. - For React component templates, see [resources/components.jsx](resources/components.jsx)
  346. - For detailed UI pattern documentation, see [resources/ui-patterns.md](resources/ui-patterns.md)
  347. ### External References
  348. - [Apple Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines)
  349. - [Apple Design Resources](https://developer.apple.com/design/resources/)
  350. - [SF Symbols](https://developer.apple.com/sf-symbols/)
  351. - [Apple Fonts](https://developer.apple.com/fonts/)
  352. ---
  353. *This skill ensures Claude Code produces interfaces that meet Apple's exacting design standards, creating cohesive, accessible, and beautiful user experiences.*
README.md · README · 156 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">Apple-Hig-Designer</h1>
  2. <div align="center">
  3. ![Apple HIG](https://img.shields.io/badge/Apple-HIG-000000?style=for-the-badge&logo=apple&logoColor=white)
  4. ![Claude Code](https://img.shields.io/badge/Claude-Code_Skill-5A67D8?style=for-the-badge)
  5. ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
  6. **Apple-Hig-Designer is used to create interfaces that conform to Apple Hig principles and blend with various styles.**
  7. [English](README.md) | [简体中文](README_CN.md)
  8. </div>
  9. ---
  10. ## 📸 Basic effect demonstration:
  11. <div align="center">
  12. Single page design
  13. "Creating iOS Page Transition Animations"
  14. <!-- Page Transitions -->
  15. ![Page Transitions](screenshots/page-transitions.gif)
  16. "Design a Mac-style chat page for web use."
  17. <!-- macOS Chat Page -->
  18. ![macOS Chat](screenshots/macos-chat.png)
  19. </div>
  20. <div align="center">
  21. 📸Style fusion design:
  22. "Please use your apple-hig-designer skills to choose a suitable framework and develop a complete responsive front-end project that incorporates a luxury brand aesthetic."
  23. Vercel: https://fashion-editorial.vercel.app/
  24. <img width="2075" height="1206" alt="image" src="https://github.com/user-attachments/assets/605fa6b0-51a9-440d-b0b0-a3578988ecf3" />
  25. </div>
  26. ## 🎯 Overview
  27. This apple-hig-designer enables you to design professional web and mobile interfaces that follow Apple's Human Interface Guidelines. It provides comprehensive knowledge about:
  28. - **SF Pro Typography** system
  29. - **Apple System Colors** with light/dark mode support
  30. - **8pt Grid Spacing System**
  31. - **Component Patterns** (buttons, cards, inputs, etc.)
  32. - **Animation Guidelines** with Apple-standard easing curves
  33. ## 📦 Installation
  34. ### Method 1: User-level Installation (Recommended)
  35. Copy the skill to your Claude Code skills directory:
  36. ```bash
  37. # Windows
  38. xcopy /E /I "apple-hig-designer" "%USERPROFILE%\.claude\skills\apple-hig-designer"
  39. # macOS / Linux
  40. cp -r apple-hig-designer ~/.claude/skills/
  41. ```
  42. ### Method 2: Project-level Installation
  43. Copy to your project's `.claude/skills` directory:
  44. ```bash
  45. mkdir -p .claude/skills
  46. cp -r apple-hig-designer .claude/skills/
  47. ```
  48. ## 🚀 Usage
  49. After installation, Claude Code will automatically activate this skill when you perform the following actions:
  50. Basic usage: Please tell Claude Code that you want to use apple-hig-designer.
  51. Example
  52. - "Design an Apple-style..."
  53. - "Create a HIG-compliant..."
  54. - "iOS-style components"
  55. Advanced usage: Integrate apple-hig-designer with other styles, using apple-hig-designer as the basic design framework.
  56. Example
  57. "Using your apple-hig-designer skills and a cyberpunk aesthetic, could you help me develop a robot showcase page?"
  58. "Using apple-hig-designer skills to blend other styles, how would you recommend a style for developing a blog-themed website?"
  59. ## 📁 File Structure
  60. ```
  61. apple-hig-designer/
  62. ├── SKILL.md # Main skill definition
  63. ├── REFERENCE.md # Detailed HIG reference documentation
  64. ├── README.md # English documentation
  65. ├── README_CN.md # Chinese documentation
  66. ├── LICENSE # MIT License
  67. └── resources/
  68. ├── components.jsx # React component examples
  69. ├── design-tokens.css # CSS custom properties
  70. └── ui-patterns.md # UI pattern documentation
  71. ```
  72. ## 🎨 Features
  73. | Feature | Description |
  74. |---------|-------------|
  75. | **Typography** | SF Pro font system with proper size thresholds |
  76. | **Colors** | Complete Apple system color palette |
  77. | **Spacing** | 8pt grid system implementation |
  78. | **Components** | Buttons, cards, inputs, glass panels |
  79. | **Animations** | Apple-standard cubic-bezier easing |
  80. | **Accessibility** | WCAG AA compliant, reduced motion support |
  81. | **Dark Mode** | Full light/dark mode support |
  82. ## 📚 Resources
  83. - [Apple Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines)
  84. - [Apple Design Resources](https://developer.apple.com/design/resources/)
  85. - [SF Symbols](https://developer.apple.com/sf-symbols/)
  86. ## 🤝 Contributing
  87. Contributions are welcome! Feel free to submit Issues and Pull Requests.
  88. ## 📄 License
  89. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  90. ---
  91. <div align="center">
  92. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.