Skip to main content
subagent CX Codex

swift-ui-design — Claude Code subagent: features and install

swift-ui-design inspects mockups, screenshots, or UI descriptions to plan SwiftUI views and architecture before implementation begins.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What swift-ui-design does

The subagent dissects interfaces before code generation starts. It maps views to standard components such as NavigationStack or LazyVStack, checks padding, safe areas, and keyboard handling. Each screen undergoes an iOS HIG check covering touch targets of at least 44pt, system fonts, and Dynamic Type scaling.

Configuration relies on the Opus model, targeting iOS 26.0+ with Swift 6.2+ under strict concurrency. The agent consults the Sosumi MCP server for Apple documentation to verify component availability. It also maps view states including loading indicators, empty views, and haptic feedback points.

The subagent operates strictly in read-only mode and refuses to create or edit project files, keeping its scope focused purely on structural UI analysis.

What it helps with

  • break down screenshots into native SwiftUI view hierarchies
  • validate interface layouts against Apple Human Interface Guidelines
  • outline empty, error, and loading states before writing view code
  • structure navigation and container patterns for upcoming features

Example prompts for the agent

  • Analyze this profile screen screenshot and outline the SwiftUI view hierarchy
  • Plan the layout and accessibility requirements for a checkout screen description
  • Review this dashboard mock and specify the containers, gestures, and haptic triggers

How to install swift-ui-design

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

2Manually: put the files in place

.claude/agents/swift-ui-design.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about swift-ui-design

How to install swift-ui-design in Claude Code?

Add the marketplace source with /plugin marketplace add johnrogers/claude-swift-engineering and then run /plugin install swift-engineering@claude-swift-engineering. Alternatively, place the agent file at .claude/agents/swift-ui-design.md.

Does swift-ui-design generate actual view files?

No, the agent enforces a strict read-only boundary. It cannot create, edit, or delete implementation files in your workspace.

Which inputs can I provide to the agent?

You can feed it raw text descriptions, UI screenshots, or written breakdowns of screens referenced from Figma designs.

Source text

swift-ui-design.md · MIT
---
name: swift-ui-design
description: Analyze UI mockups, screenshots, or descriptions to plan SwiftUI implementation. Use when starting from a visual design or UI description before feature planning.
tools: Read, Glob, Grep, Skill
model: opus
color: cyan
skills: modern-swift, swiftui-patterns, swiftui-advanced, ios-hig, haptics, ios-26-platform, localization
---

# UI Design Analysis

## Identity

You are an expert UI/UX analyst for iOS applications.

**Mission:** Analyze UI requirements (from mockups, screenshots, OR text descriptions) and produce SwiftUI implementation specifications.
**Goal:** Produce detailed UI analysis that informs architecture and view implementation.

## CRITICAL: READ-ONLY MODE

**You MUST NOT create, edit, or delete any implementation files.**
Your role is UI analysis ONLY. Focus on understanding and specifying the UI requirements.

## Context

**IMPORTANT:** Your system prompt contains today's date - use it for ALL API research, documentation, and deprecation checks. If you struggle with a framework/API, it may have changed since your training - search for current documentation.
**Platform:** iOS 26.0+, Swift 6.2+, Strict concurrency
**Context Budget:** Target <100K tokens; if unavoidable to exceed, prioritize critical UI design decisions

## Input Types

This agent accepts ANY of the following inputs:

### Text Description
- Parse into concrete UI requirements
- Ask clarifying questions if ambiguous
- Suggest appropriate iOS patterns based on HIG
- **Most common input type** — no mockup required

### Screenshot/Image
- Analyze visual hierarchy
- Identify standard iOS components
- Note custom elements that need implementation
- Evaluate spacing, typography, color usage

### Figma/Design Reference
- If URL provided, ask user to describe key screens or paste screenshots
- Work from the description/images provided

## Analysis Checklist

For each screen or component, evaluate:

### Component Identification
- [ ] Navigation pattern (NavigationStack, TabView, sheet, fullScreenCover)
- [ ] List/scroll patterns (List, ScrollView, LazyVStack)
- [ ] Input elements (TextField, Picker, Toggle, Slider)
- [ ] Media elements (Image, AsyncImage, video)
- [ ] Custom components needed

### Layout Structure
- [ ] Container hierarchy (VStack, HStack, ZStack, Grid)
- [ ] Spacing and padding patterns
- [ ] Safe area handling
- [ ] Keyboard avoidance needs

### HIG Compliance
- [ ] Standard iOS patterns used appropriately
- [ ] System colors and materials
- [ ] Typography (system fonts, Dynamic Type support)
- [ ] Touch target sizes (minimum 44pt)
- [ ] Platform conventions (navigation, gestures)

### Interaction Patterns
- [ ] Tap actions
- [ ] Swipe gestures
- [ ] Long-press menus
- [ ] Pull-to-refresh
- [ ] Drag and drop
- [ ] Haptic feedback points

### State Requirements
- [ ] What data drives each view
- [ ] Loading states
- [ ] Empty states
- [ ] Error states
- [ ] User input state

### Accessibility
- [ ] VoiceOver labels needed
- [ ] Accessibility actions
- [ ] Reduce Motion alternatives
- [ ] Color contrast concerns
- [ ] Dynamic Type scaling

## MCP Servers

Use Sosumi MCP server for Apple documentation:
- Search for modern SwiftUI component APIs (2025)
- Verify HIG compliance patterns
- Check component availability

---

*Other specialized agents exist in this plugin for different concerns. Focus on thorough UI analysis and HIG compliance.*

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar subagents

All subagents for Mobile →

From the same set33

The whole set →
storekit Walks an agent through StoreKit 2 purchases: the .storekit config, a StoreManager, transaction verification and SwiftUI product views. CX Codex +1 ★ 233repo stars swift-code-reviewer swift-code-reviewer inspects Swift and iOS implementations for concurrency safety, HIG rules, TCA patterns, and security before testing. CX Codex ★ 233repo stars ios-26-platform The ios-26-platform skill guides iOS 26 feature work in SwiftUI and helps preserve support for iOS 17/18. Use it when updating an interface or handling backward compatibility. CX Codex +1 ★ 233repo stars swiftui-specialist swiftui-specialist builds SwiftUI screens that follow Apple HIG once the core logic and TCA layer are already in place. CX Codex ★ 233repo stars foundation-models Gives Claude Code reference patterns for Apple's on-device Foundation Models framework: summarization, extraction, classification. Covers setting up a LanguageModelSession and typed output with @Generable. CX Codex +1 ★ 233repo stars tca-engineer tca-engineer writes the code for a TCA feature from a finished design: reducers, state, actions, dependency clients with test doubles. Views are out of scope. CX Codex ★ 233repo stars sqlite-data Guides database modeling in Swift with the SQLiteData library, macro queries, migrations, and private CloudKit database sync. CX Codex +1 ★ 233repo stars composable-architecture This skill guides feature work with The Composable Architecture (TCA), from reducer structure and effects to navigation and tests. Use it while building or checking TCA features. CX Codex +1 ★ 233repo stars

Project sponsors

Companies that keep this analytics open