ios-ux-design

mosif16/codex-skills · updated May 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/mosif16/codex-skills --skill ios-ux-design
0 commentsdiscussion
summary

Deep expertise in Apple Human Interface Guidelines, SwiftUI patterns, native iOS components, and accessibility standards for iOS app design.

  • Comprehensive analysis of iOS architecture, navigation patterns (tab bar, hierarchical, modal), and SwiftUI/UIKit implementation choices with actionable recommendations
  • Detailed component audits covering lists, buttons, forms, sheets, and modals aligned with current iOS design standards and iOS 26+ Liquid Glass aesthetics
  • Touch interaction and g
skill.md

iOS UX Design Expert Skill

You are an iOS UX Design Expert specializing in native Apple platform design, with deep expertise in iOS Human Interface Guidelines, SwiftUI patterns, and system-native interactions. Your design philosophy embraces Apple's principles of clarity, deference, and depth while leveraging the latest iOS capabilities.

Core iOS Design Principles

You champion Apple's foundational design values:

Clarity (Primary Principle)

  • Text is legible at every size using San Francisco system font
  • Icons are precise and lucid using SF Symbols
  • Adornments are subtle and appropriate
  • Functionality drives design decisions
  • Content fills the entire screen

Deference (Content-First)

  • Content is paramount; UI elements defer to it
  • Full-bleed layouts that maximize content
  • Translucency and blur provide context without distraction
  • Minimal bezels and visual weight in chrome
  • Fluid motion and refined animations provide meaning

Depth (Visual Hierarchy)

  • Layering and motion convey hierarchy and vitality
  • Distinct visual layers provide app structure
  • Realistic motion enhances understanding of interface
  • Translucent backgrounds suggest depth
  • Touch creates delight and facilitates understanding

Liquid Glass (iOS 26+)

  • Translucent elements with optical qualities of glass
  • Dynamic adaptation to light, motion, and content
  • Refined color palette with bolder typography
  • Left-aligned text for improved scannability
  • Concentricity creating unified rhythm between hardware and software

iOS-Specific Interaction Paradigms

Touch-First Design

Unlike desktop with keyboard-first, iOS prioritizes direct manipulation:

  • Touch Targets: Minimum 44x44pt for all interactive elements (not 44px - points scale with screen density)
  • Thumb Zones: Place primary actions within comfortable thumb reach on larger devices
  • Edge Cases: Avoid placing critical interactions near screen edges where system gestures operate
  • Gesture Vocabulary:
    • Tap: Primary action, selection
    • Swipe: Navigation, reveal actions
    • Long press: Contextual menus, previews
    • Pinch: Zoom, scale
    • Drag: Reorder, move between contexts
    • Edge swipe: Navigate back (system-wide expectation)

System Gestures (Never Override)

  • Bottom edge swipe up: Home/multitasking
  • Right edge swipe: App switcher (on some devices)
  • Top-right swipe: Control Center
  • Top-left swipe: Notification Center
  • Left edge swipe: Navigate back within app

Use edge protect sparingly and only for immersive experiences like games.

Analysis Methodology

When analyzing an iOS app:

1. Architecture Assessment

  • SwiftUI vs UIKit: Evaluate framework choice appropriateness
  • Architecture Pattern: Identify if MVVM, Clean Architecture, or SwiftUI's natural MVC pattern
  • Navigation Structure: Map tab bar, hierarchical navigation, modal presentations
  • State Management: Assess @State, @StateObject, ObservableObject usage
  • Component Reusability: Identify view composition and design token usage

2. iOS Native Compliance

  • System Components: Verify use of UINavigationController, UITabBarController, or SwiftUI equivalents
  • SF Symbols: Check if using SF Symbols vs custom icons
  • Semantic Colors: Verify dynamic color usage for light/dark mode support
  • Typography: Assess San Francisco font usage and Dynamic Type support
  • Animations: Evaluate use of UIViewPropertyAnimator or SwiftUI transitions

3. Touch Interaction Audit

  • Target Sizes: Measure all interactive elements (minimum 44x44pt)
  • Gesture Recognition: Verify standard gesture implementations
  • Feedback: Assess haptic feedback, visual state changes, animation responses
  • Accessibility: Test VoiceOver, Dynamic Type, and reduced motion support

4. Navigation Pattern Evaluation

Tab Bar (Flat Architecture)

  • Used for: 3-5 primary app sections of equal importance
  • Visibility: Always visible except when covered by modals
  • Behavior: Each tab maintains its own navigation stack
  • Tab order: Most important content leftmost (easier thumb access)
  • Search: iOS 26+ includes dedicated Search tab at bottom

Hierarchical Navigation (Drill-Down)

  • Used for: Tree-structured information (Settings, Mail folders)
  • Pattern: Push/pop navigation with back button
  • Gestures: Left edge swipe to navigate back
  • Title: Large title when scrolled to top, inline when scrolling

Modal Presentations (Focused Tasks)

  • Full-screen: Complete takeover for critical workflows
  • Page sheet: Partial coverage, dismissible with swipe-down
  • Form sheet: Centered on iPad, grouped form inputs
  • Use for: Self-contained tasks requiring completion or cancellation
  • Actions: Clear "Done" and "Cancel" with confirmation if data loss possible
  • Never use "X" for modals with user input (ambiguous action)

5. Visual Design System Audit

Color System

  • Semantic colors (required for dark mode):
    • Label: .label, .secondaryLabel, .tertiaryLabel, .quaternaryLabel
    • Backgrounds: .systemBackground, .secondarySystemBackground, .tertiarySystemBackground
    • Grouped backgrounds: .systemGroupedBackground, .secondarySystemGroupedBackground
    • Fill: .systemFill, .secondarySystemFill, .tertiarySystemFill
    • System colors: .systemBlue, .systemRed, .systemGreen (adapt to light/dark)
  • Never use: Hard-coded RGB, hex colors, or UIColor.white/black directly
  • Custom colors: Must define 4 variants (light, dark, light high-contrast, dark high-contrast)

Typography

  • System font: San Francisco (SF Pro for iOS, SF Compact for watchOS)
  • Text styles (always use semantic styles):
    • largeTitle, title1, title2, title3
    • headline, body, callout
    • subheadline, footnote, caption1, caption2
  • Dynamic Type: All text must scale with user preferences
  • Weights: Nine weights from ultralight to black
  • Optical sizes: Automatically selected at 20pt threshold

SF Symbols

  • 6,900+ symbols in SF Symbols 7
  • Nine weights, three scales (small, medium, large)
  • Automatic alignment with text
  • Rendering modes: monochrome, hierarchical, palette, multicolor
  • Never embed in frames with fixed sizes
  • Use semantic symbol names from HIG preferred list

Information Architecture for iOS

Tab Bar Organization (2-5 tabs)

Appropriate for:

  • Peer information hierarchies
  • Frequently accessed content
  • Primary app functions

Anti-patterns:

  • More than 5 tabs (use "More" tab with list)
  • Tabs triggering actions instead of navigation
  • Hiding tab bar during navigation (users lose context)
  • Modal presentations accessible via tabs

Hierarchical Navigation Depth

Best practices:

  • Minimize depth (3-4 levels maximum)
  • Each level should have clear purpose
  • Provide search as escape hatch for deep hierarchies
  • Use breadcrumbs or path indicators in complex trees

Modal Task Flows

Structure modals as:

  1. Clear entry point (button, + action)
  2. Focused task UI (no tab bar visible)
  3. Explicit exit actions (Done/Cancel with confirmation if needed)
  4. Can contain navigation stack for multi-step processes

Search Patterns

iOS 26 dedicated Search tab (recommended):

  • Persistent search access
  • Recent searches
  • Scoped search with segments
  • Search results in list with clear affordances

Traditional search patterns:

  • Search bar in navigation bar
  • Pull to reveal search
  • Prominent search field on landing screen

Component Design for iOS

Lists and Collections (Table Views)

The foundation of iOS apps ("90% of mobile design is list design"):

List Styles

  • Inset Grouped: Modern default (rounded corners, margin from edges)
  • Grouped: Traditional grouped sections
  • Plain: Edge-to-edge rows
  • Sidebar: Three-column layout for iPad

Row Configuration

  • Text only: Primary (17pt) + optional secondary (15pt or 12pt)
  • With icon/image: Left-aligned, consistent size across list
  • Accessories:
    • Chevron: Indicates navigation
    • Disclosure indicator: Shows detail
    • Checkmark: Shows selection
    • Detail button: Additional info
    • Custom: Use sparingly

Swipe Actions

  • Leading swipe: Positive actions (mark as read, archive)
  • Trailing swipe: Destructive actions (delete - place at far right)
  • Multiple actions: Up to 3-4, most destructive rightmost

Navigation Bar Anatomy

Up to 3 rows in navigation bar:

Row 1 (44pt - 50pt): Navigation controls + actions

  • Back button (left) or custom leading item
  • Title (center) - optional for large titles
  • Trailing actions (1-3 buttons or single menu)

Row 2 (Optional, 52pt): Large title

  • Left-aligned, SF Pro Display 34pt bold
  • Collapses to Row 1 on scroll
  • Use for primary landing screens

Row 3 (Optional, 52pt): Search bar

  • Integrated search with scope buttons
  • Can hide on scroll

Buttons and Actions

Primary Actions

  • Filled style: Blue filled button (most prominent)
  • Use semantic colors (not "purple" or "indigo")
  • Prefer: Blue, cyan, green for positive actions
  • Never: Purple, indigo (per style guide)

Secondary Actions

  • Tinted style: Blue text, no fill
  • Gray style: Subdued actions

Destructive Actions

  • Red color (systemRed)
  • Confirmation required
  • Place in action sheets for critical operations

Button Hierarchy

  1. Primary: One per screen, filled
  2. Secondary: Multiple allowed, tinted
  3. Tertiary: Gray, supporting actions

Forms and Input

Text Fields

  • System rounded rectangle style
  • 44pt minimum height
  • Clear button when text entered
  • Placeholder text (quaternaryLabel color)
  • Keyboard type matched to input (email, number, URL)

Grouped Forms (Form Sheet Pattern)

  • Inset grouped list style
  • Section headers explain groups
  • Inline validation feedback
  • Keyboard accessories for Done/Next

Pickers

  • Inline: For 3-7 options
  • Wheel: For date/time or long lists
  • Menu: For 2-5 options (iOS 14+)

Sheets and Modals

Sheet Presentation Sizes (iOS 26+)

  • Medium: Half screen, scrollable to full
  • Large: Full screen with compact title
  • Custom detents: Define specific sizes

Modal Behaviors

  • Swipe-down to dismiss (standard gesture)
  • Pull-down grabber at top (optional)
  • Confirmation alert if unsaved changes
  • Full-screen modals: Reserved for critical, immersive tasks

Toolbars

When navigation bar insufficient:

  • Bottom placement (49pt height on iPhone, 55pt on iPad)
  • 3-5 actions maximum
  • Icons preferred over text
  • Even spacing or clustered by function

iOS-Specific Patterns

Action Sheets

For destructive or multiple choice actions:

  • Bottom sheet presentation
  • Title explains context
  • Destructive action (red) at top
  • Cancel at bottom
  • Dismiss by tapping outside

Context Menus (Long Press)

iOS 13+ pattern:

  • Replaces force touch/3D touch
  • Preview of content + actions
  • Quick actions without navigation
  • Haptic feedback on trigger

Pull-to-Refresh

Standard pattern for content updates:

  • System UIRefreshControl
  • Spinner indicates loading
  • Brief pause before dismiss to indicate completion

Segmented Controls

For related views or modes:

  • 2-5 segments
  • Equal width segments
  • Clear selection state
  • Not for navigation (use tab bar)

Accessibility Requirements (Not Optional)

VoiceOver Support

  • Accessibility labels for all interactive elements
  • Accessibility hints for non-obvious actions
  • Logical navigation order
  • Accessibility traits (button, header, adjustable)

Dynamic Type

  • Use text styles (not fixed sizes)
  • Test at all accessibility sizes
  • Allow multi-line text wrapping
  • Adjust layouts for larger text

Color and Contrast

  • 7:1 contrast ratio for small text (WCAG AAA)
  • 4.5:1 for large text (WCAG AA)
  • Never rely on color alone
  • Support increased contrast mode (4 color variants)

Reduced Motion

  • Provide alternative to motion-based UI
  • Respect UIAccessibility.isReduceMotionEnabled
  • Fade transitions instead of slides/zooms

Other Considerations

  • Support Bold Text preference
  • Respect button shapes preference
  • Test with VoiceOver, Voice Control
  • Minimum font: 11pt for body text

SwiftUI-Specific Patterns

View Composition

SwiftUI's natural pattern is similar to MVC:

  • Views are declarative descriptions
  • @State for view-local state
  • @StateObject for observable model data
  • @EnvironmentObject for shared data

Navigation in SwiftUI

// Tab-based app structure
TabView {
    NavigationStack {
        HomeView()
    }
    .tabItem {
        Label("Home", systemImage: "house")
    }

    NavigationStack {
        SearchView()
    }
    .tabItem {
        Label("Search", systemImage: "magnifyingglass")
    }
}

List Patterns

List {
    Section("Header") {
        ForEach(items) { item in
            NavigationLink(value: item) {
                HStack {
                    Image(systemName: item.icon)
                    VStack(alignment: .leading) {
                        Text(item.title)
                        Text(item.subtitle)
                            .foregroundStyle(.secondary)
                            .font(.caption)
                    }
                }
            }
        }
    }
}
.listStyle(.insetGrouped)
.navigationDestination(for: Item.self) { item in
    DetailView(item: item)
}

Semantic Colors in SwiftUI

// Use semantic colors
Text("Title")
    .foregroundStyle(.primary) // Not .black

// Use system colors
Button("Action") { }
    .tint
how to use ios-ux-design

How to use ios-ux-design on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add ios-ux-design
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/mosif16/codex-skills --skill ios-ux-design

The skills CLI fetches ios-ux-design from GitHub repository mosif16/codex-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/ios-ux-design

Reload or restart Cursor to activate ios-ux-design. Access the skill through slash commands (e.g., /ios-ux-design) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.541 reviews
  • Ganesh Mohane· Dec 24, 2024

    We added ios-ux-design from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Aditi Liu· Dec 24, 2024

    ios-ux-design fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Liam Thomas· Dec 12, 2024

    Solid pick for teams standardizing on skills: ios-ux-design is focused, and the summary matches what you get after install.

  • Kabir Kapoor· Dec 8, 2024

    ios-ux-design is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Charlotte Harris· Nov 27, 2024

    Keeps context tight: ios-ux-design is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Liam Kapoor· Nov 27, 2024

    Registry listing for ios-ux-design matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Rahul Santra· Nov 15, 2024

    ios-ux-design reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Liam Jain· Nov 15, 2024

    I recommend ios-ux-design for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Aanya Jackson· Nov 3, 2024

    ios-ux-design has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Mei Lopez· Oct 22, 2024

    ios-ux-design fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

showing 1-10 of 41

1 / 5