apple-hig-designer
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.
Badge for your README
Markdown
[](/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
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)
- ---
- name: apple-hig-designer
- 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.
- ---
- # Apple HIG Designer
- 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.
- ## When to Use This Skill
- Activate this skill when users request:
- - Apple-style or iOS/macOS-style interfaces
- - HIG-compliant UI components
- - SF Symbols integration
- - San Francisco typography implementation
- - Modern glass effects (optional, user must explicitly request)
- **Trigger phrases:**
- - "Design an Apple-style..."
- - "Create a HIG-compliant..."
- - "iOS/macOS style component"
- - "苹果风格的界面"
- - "符合 HIG 的设计"
- ---
- ## Core Design Principles
- ### The Four Pillars of Apple Design
- 1. **Clarity (清晰)**
- - Every element has a purpose
- - Eliminate unnecessary complexity
- - Users understand immediately without instructions
- - Use clear visual hierarchy
- 2. **Deference (尊重内容)**
- - UI elements support, not compete with content
- - Minimize chrome and visual noise
- - Let content be the hero
- - Use subtle backgrounds and borders
- 3. **Depth (层次)**
- - Create clear visual hierarchy through layers
- - Use shadows, blur, and translucency purposefully
- - Motion reinforces spatial relationships
- - Z-axis communicates importance
- 4. **Consistency (一致性)**
- - Familiar patterns across platforms
- - Predictable interactions
- - Unified visual language
- - Respect platform conventions
- ---
- ## Design System Specifications
- ### Typography System
- **Font Family:** San Francisco (SF Pro)
- ```css
- /* System Font Stack for Web */
- :root {
- --font-system: -apple-system, BlinkMacSystemFont, 'SF Pro Display',
- 'SF Pro Text', 'Helvetica Neue', Arial, sans-serif;
- --font-mono: 'SF Mono', SFMono-Regular, Menlo, Monaco, monospace;
- }
- /* Font Size Scale (iOS) */
- --text-caption2: 11px; /* Caption 2 */
- --text-caption1: 12px; /* Caption 1 */
- --text-footnote: 13px; /* Footnote */
- --text-subhead: 15px; /* Subheadline */
- --text-body: 17px; /* Body - Default */
- --text-headline: 17px; /* Headline (semibold) */
- --text-title3: 20px; /* Title 3 */
- --text-title2: 22px; /* Title 2 */
- --text-title1: 28px; /* Title 1 */
- --text-large-title: 34px; /* Large Title */
- ```
- **Typography Rules:**
- - Use SF Pro Display for sizes ≥ 20pt
- - Use SF Pro Text for sizes < 20pt
- - Maintain consistent line-height (1.2-1.5)
- - Use weight for hierarchy, not just size
- ### Color System
- ```css
- /* Apple System Colors - Light Mode */
- :root {
- /* Primary Colors */
- --system-blue: #007AFF;
- --system-green: #34C759;
- --system-indigo: #5856D6;
- --system-orange: #FF9500;
- --system-pink: #FF2D55;
- --system-purple: #AF52DE;
- --system-red: #FF3B30;
- --system-teal: #5AC8FA;
- --system-yellow: #FFCC00;
- /* Gray Scale */
- --system-gray: #8E8E93;
- --system-gray2: #AEAEB2;
- --system-gray3: #C7C7CC;
- --system-gray4: #D1D1D6;
- --system-gray5: #E5E5EA;
- --system-gray6: #F2F2F7;
- /* Semantic Colors */
- --label-primary: #000000;
- --label-secondary: rgba(60, 60, 67, 0.6);
- --label-tertiary: rgba(60, 60, 67, 0.3);
- --label-quaternary: rgba(60, 60, 67, 0.18);
- /* Backgrounds */
- --bg-primary: #FFFFFF;
- --bg-secondary: #F2F2F7;
- --bg-tertiary: #FFFFFF;
- /* Separators */
- --separator: rgba(60, 60, 67, 0.29);
- --separator-opaque: #C6C6C8;
- }
- /* Dark Mode */
- @media (prefers-color-scheme: dark) {
- :root {
- --system-blue: #0A84FF;
- --system-green: #30D158;
- --system-indigo: #5E5CE6;
- --system-orange: #FF9F0A;
- --system-pink: #FF375F;
- --system-purple: #BF5AF2;
- --system-red: #FF453A;
- --system-teal: #64D2FF;
- --system-yellow: #FFD60A;
- --system-gray: #8E8E93;
- --system-gray2: #636366;
- --system-gray3: #48484A;
- --system-gray4: #3A3A3C;
- --system-gray5: #2C2C2E;
- --system-gray6: #1C1C1E;
- --label-primary: #FFFFFF;
- --label-secondary: rgba(235, 235, 245, 0.6);
- --label-tertiary: rgba(235, 235, 245, 0.3);
- --label-quaternary: rgba(235, 235, 245, 0.18);
- --bg-primary: #000000;
- --bg-secondary: #1C1C1E;
- --bg-tertiary: #2C2C2E;
- --separator: rgba(84, 84, 88, 0.6);
- --separator-opaque: #38383A;
- }
- }
- ```
- ### Spacing System
- **8pt Grid System:**
- ```css
- :root {
- --space-1: 4px; /* Extra small */
- --space-2: 8px; /* Small */
- --space-3: 12px; /* Medium-small */
- --space-4: 16px; /* Medium */
- --space-5: 20px; /* Medium-large */
- --space-6: 24px; /* Large */
- --space-8: 32px; /* Extra large */
- --space-10: 40px; /* 2X large */
- --space-12: 48px; /* 3X large */
- }
- ```
- **Touch Target Requirements:**
- - **iOS:** Minimum 44×44 points
- - **visionOS:** Minimum 60 points tap area
- - Always add sufficient padding for small visual elements
- ### Border Radius (Concentric Design)
- ```css
- :root {
- /* Base radius values */
- --radius-sm: 8px;
- --radius-md: 12px;
- --radius-lg: 16px;
- --radius-xl: 20px;
- --radius-2xl: 24px;
- --radius-full: 9999px; /* Capsule */
- }
- /* Concentric Rule: inner_radius + padding = outer_radius */
- /* Example: 8px inner + 8px padding = 16px outer */
- ```
- ---
- ## Component Patterns
- 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).
- ### Buttons
- - **Primary:** Capsule shape (`border-radius: 9999px`), `min-height: 44px`, system-blue background, white text, 600 weight
- - **Secondary:** Same capsule shape, system-blue text on `rgba(0, 122, 255, 0.1)` background
- - **Press feedback:** `scale(0.98)` on `:active`
- ### Glass Effect (Optional - Only When Requested)
- - **Only use when user explicitly requests** glass/frosted effects
- - Default designs should use solid backgrounds for readability and performance
- - `backdrop-filter: blur(20px) saturate(180%)` with semi-transparent background
- - Always provide non-glass fallback
- ### Cards
- - **Default:** Solid background (`--bg-tertiary`), `border-radius: 16px`, subtle box-shadow
- - **Grouped style:** `--bg-secondary` outer with `--bg-tertiary` inner items, separated by `--separator`
- ### Input Fields
- - `min-height: 44px`, `--bg-secondary` background, `border-radius: 12px`
- - Focus state: `box-shadow: 0 0 0 4px rgba(0, 122, 255, 0.3)`
- ### Tab Bars
- - Position fixed at bottom, `height: 49px` + safe-area padding
- - Minimum 44x44pt touch targets per tab
- - Always display text labels (never icon-only)
- - Use filled SF Symbols for selected state, outline for unselected
- - Support badge for notifications (red oval, white text)
- ### Toolbars
- - Three sections: leading (back/title), center (tools), trailing (actions)
- - Maximum 3 item groups
- - Use SF Symbols without borders
- - Primary action uses `.prominent` style on trailing side
- - Back button: circular with symbol only (no text)
- ### Sheets
- - Detents: `large` (100%), `medium` (50%)
- - Include grabber indicator (36x5px, centered)
- - Done button: top-right; Cancel button: top-left
- - Semi-transparent backdrop `rgba(0,0,0,0.4)`
- ### Alerts
- - Use only for critical information (sparingly)
- - Maximum 3 buttons; use specific verb titles, avoid "OK"
- - Cancel: leading side; Destructive: only for unintended destructive actions
- - Width: 270px, `border-radius: 14px`
- ### Lists and Tables
- - Minimum row height: 44px
- - Info button: reveals details without navigation
- - Disclosure indicator (>): navigates to subview
- - Grouped style: 10px border-radius, inset separators start at 60px
- ---
- ## Animation Guidelines
- ### Timing Functions
- ```css
- :root {
- /* Apple's preferred easing */
- --ease-default: cubic-bezier(0.25, 0.1, 0.25, 1);
- --ease-in: cubic-bezier(0.42, 0, 1, 1);
- --ease-out: cubic-bezier(0, 0, 0.58, 1);
- --ease-in-out: cubic-bezier(0.42, 0, 0.58, 1);
- /* Spring-like easing */
- --ease-spring: cubic-bezier(0.175, 0.885, 0.32, 1.275);
- }
- ```
- ### Duration Scale
- ```css
- :root {
- --duration-instant: 100ms; /* Micro-interactions */
- --duration-fast: 200ms; /* Hover, focus states */
- --duration-normal: 300ms; /* Standard transitions */
- --duration-slow: 500ms; /* Complex animations */
- }
- ```
- ### Interaction Feedback
- ```css
- /* Press feedback */
- .interactive {
- transition: transform var(--duration-instant) var(--ease-out);
- }
- .interactive:active {
- transform: scale(0.97);
- }
- /* Hover glow */
- .interactive:hover {
- box-shadow: 0 0 0 4px rgba(0, 122, 255, 0.15);
- }
- ```
- ---
- ## SF Symbols Integration
- ### Rendering Modes
- 1. **Monochrome:** Single color for all layers
- 2. **Hierarchical:** Opacity variations for depth
- 3. **Palette:** Custom colors per layer
- 4. **Multicolor:** Apple's intrinsic symbol colors
- ### Usage Guidelines
- - **Toolbar/Navigation:** Use outline variant
- - **Tab Bar:** Use fill variant
- - **Match text size:** Symbols auto-align with SF font
- - **Provide text alternatives:** Always include aria-label
- ### Web Implementation (Icon Font Alternative)
- ```html
- <!-- Using SF Symbols via system font -->
- <span class="sf-symbol" aria-label="Settings"></span>
- <!-- Or use equivalent system icons -->
- <svg class="icon" aria-hidden="true">
- <use href="#icon-gear"></use>
- </svg>
- ```
- ---
- ## Accessibility Requirements
- ### Color Contrast
- - **Normal text:** 4.5:1 minimum (WCAG AA)
- - **Large text:** 3:1 minimum
- - **Interactive elements:** Clearly distinguishable states
- ### Motion
- ```css
- @media (prefers-reduced-motion: reduce) {
- * {
- animation-duration: 0.01ms !important;
- transition-duration: 0.01ms !important;
- }
- }
- ```
- ### Semantic HTML
- ```html
- <!-- Always use semantic elements -->
- <button type="button">Action</button>
- <nav aria-label="Main navigation">...</nav>
- <main role="main">...</main>
- ```
- ---
- ## Output Format
- When generating Apple-style UI code, always include:
- 1. **Complete, runnable code** (CSS/React/Vue)
- 2. **Light/Dark mode support** via CSS custom properties
- 3. **Design rationale** explaining HIG compliance
- 4. **Responsive breakpoints** for different devices
- 5. **Accessibility attributes** (aria-*, role, etc.)
- ### Default Behavior
- - **Use solid backgrounds by default** for better readability
- - **Glass/blur effects only when user explicitly requests**
- - **Always provide non-glass fallback** for browsers without backdrop-filter support
- ### Example Output Structure
- ```jsx
- /**
- * Apple HIG Compliant Component
- *
- * Design Decisions:
- * - Uses SF Pro system font stack for native feel
- * - 44pt minimum touch target for accessibility
- * - Capsule shape for primary actions (HIG recommendation)
- * - Solid background for optimal readability
- * - Supports prefers-color-scheme for auto theming
- */
- const AppleButton = ({ children, variant = 'primary', ...props }) => {
- return (
- <button
- className={`btn btn-${variant}`}
- {...props}
- >
- {children}
- </button>
- );
- };
- ```
- ---
- ## Best Practices Checklist
- Before finalizing any design output, verify:
- - [ ] **Typography:** Using SF Pro with correct size thresholds
- - [ ] **Colors:** System colors with Light/Dark variants
- - [ ] **Spacing:** Following 8pt grid
- - [ ] **Touch targets:** Minimum 44×44pt
- - [ ] **Border radius:** Concentric relationships maintained
- - [ ] **Animations:** Using Apple-standard easing curves
- - [ ] **Accessibility:** WCAG AA compliant, reduced motion support
- - [ ] **Consistency:** Matches platform conventions
- - [ ] **Backgrounds:** Solid by default, glass only when requested
- ---
- ## Additional Resources
- ### Local References (read these for detailed implementations)
- - For complete design patterns and real-world examples, see [REFERENCE.md](REFERENCE.md)
- - For CSS custom properties and design tokens, see [resources/design-tokens.css](resources/design-tokens.css)
- - For React component templates, see [resources/components.jsx](resources/components.jsx)
- - For detailed UI pattern documentation, see [resources/ui-patterns.md](resources/ui-patterns.md)
- ### External References
- - [Apple Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines)
- - [Apple Design Resources](https://developer.apple.com/design/resources/)
- - [SF Symbols](https://developer.apple.com/sf-symbols/)
- - [Apple Fonts](https://developer.apple.com/fonts/)
- ---
- *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)
- <h1 align="center">Apple-Hig-Designer</h1>
- <div align="center">
- 
- 
- 
- **Apple-Hig-Designer is used to create interfaces that conform to Apple Hig principles and blend with various styles.**
- [English](README.md) | [简体中文](README_CN.md)
- </div>
- ---
- ## 📸 Basic effect demonstration:
- <div align="center">
- Single page design
- "Creating iOS Page Transition Animations"
- <!-- Page Transitions -->
- 
- "Design a Mac-style chat page for web use."
- <!-- macOS Chat Page -->
- 
- </div>
- <div align="center">
- 📸Style fusion design:
- "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."
- Vercel: https://fashion-editorial.vercel.app/
- <img width="2075" height="1206" alt="image" src="https://github.com/user-attachments/assets/605fa6b0-51a9-440d-b0b0-a3578988ecf3" />
- </div>
- ## 🎯 Overview
- 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:
- - **SF Pro Typography** system
- - **Apple System Colors** with light/dark mode support
- - **8pt Grid Spacing System**
- - **Component Patterns** (buttons, cards, inputs, etc.)
- - **Animation Guidelines** with Apple-standard easing curves
- ## 📦 Installation
- ### Method 1: User-level Installation (Recommended)
- Copy the skill to your Claude Code skills directory:
- ```bash
- # 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:
- ```bash
- mkdir -p .claude/skills
- cp -r apple-hig-designer .claude/skills/
- ```
- ## 🚀 Usage
- After installation, Claude Code will automatically activate this skill when you perform the following actions:
- Basic usage: Please tell Claude Code that you want to use apple-hig-designer.
- Example
- - "Design an Apple-style..."
- - "Create a HIG-compliant..."
- - "iOS-style components"
- Advanced usage: Integrate apple-hig-designer with other styles, using apple-hig-designer as the basic design framework.
- Example
- "Using your apple-hig-designer skills and a cyberpunk aesthetic, could you help me develop a robot showcase page?"
- "Using apple-hig-designer skills to blend other styles, how would you recommend a style for developing a blog-themed website?"
- ## 📁 File Structure
- ```
- apple-hig-designer/
- ├── SKILL.md # Main skill definition
- ├── REFERENCE.md # Detailed HIG reference documentation
- ├── README.md # English documentation
- ├── README_CN.md # Chinese documentation
- ├── LICENSE # MIT License
- └── resources/
- ├── components.jsx # React component examples
- ├── design-tokens.css # CSS custom properties
- └── ui-patterns.md # UI pattern documentation
- ```
- ## 🎨 Features
- | Feature | Description |
- |---------|-------------|
- | **Typography** | SF Pro font system with proper size thresholds |
- | **Colors** | Complete Apple system color palette |
- | **Spacing** | 8pt grid system implementation |
- | **Components** | Buttons, cards, inputs, glass panels |
- | **Animations** | Apple-standard cubic-bezier easing |
- | **Accessibility** | WCAG AA compliant, reduced motion support |
- | **Dark Mode** | Full light/dark mode support |
- ## 📚 Resources
- - [Apple Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines)
- - [Apple Design Resources](https://developer.apple.com/design/resources/)
- - [SF Symbols](https://developer.apple.com/sf-symbols/)
- ## 🤝 Contributing
- Contributions are welcome! Feel free to submit Issues and Pull Requests.
- ## 📄 License
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
- ---
- <div align="center">
- </div>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.