A cloneable template for bootstrapping SwiftUI iOS apps — designed for rapid, AI-assisted development.
CLAUDE.md— Coding standards, architecture rules, and naming conventions baked in as agent instructions.docs/SETUP.md— Step-by-step guide to create a new Xcode project inside this template and configure the agent verification tools.ios-verify-uiplugin — Claude Code skills to build, test, and visually verify your app directly from the agent. See Build & Verify below.
- Claude Code
- Xcode 16+ (Xcode 26+ for built-in MCP bridge)
- iOS 18+ deployment target
- Swift 5.9+
- Node.js (for XcodeBuildMCP)
-
Clone this repo:
git clone https://github.com/vivqu/SwiftUIAgentToolkit.git my-app cd my-app -
Create an Xcode project inside the folder (see docs/SETUP.md for details).
-
Install the agent verification tools (see docs/SETUP.md § Agent verification tools):
- Adds the Xcode MCP bridge tool for Xcode 26.3
- Register XcodeBuildMCP as a Claude Code MCP server
- Install the ios-verify-ui plugin
-
Open Claude Code and start building.
Three slash commands are available once the ios-verify-ui plugin is installed:
claude plugin add https://github.com/vivqu/claude-swift-verify-ui-plugin| Command | When to use |
|---|---|
/ios-verify-ui:verify-ui |
After any visual change — builds, launches on simulator, takes a screenshot, checks layout and contrast |
/ios-verify-ui:verify-test |
After adding or changing logic with tests — runs the full unit and UI test suite |
/ios-verify-ui:verify |
Full check — runs both UI and test verification in sequence |
When building screens that need realistic-looking placeholder content, use the /placeholder-ui skill. It provides bundled images across four categories — no network required:
| Category | Count | Use for |
|---|---|---|
| Avatars (illustrated) | 6 | Profile photos, social UI |
| Avatars (photo) | 6 | Realistic portrait UI |
| Products | 10 | Product cards, shop listings |
| Heroes (nature + architecture) | 6 | Full-width banners, feature headers |
| Abstracts | 6 | Decorative backgrounds, empty states |
The skill handles importing images into Assets.xcassets and includes SF Symbol references for prototype icons.
This template enforces a consistent SwiftUI architecture:
- MVVM with
@Observablemacro (notObservableObject) - SwiftUI-first — no UIKit unless absolutely necessary
- Async/await for all async work
- Safe areas respected — content never underlaps the status bar or Dynamic Island
- Accessibility identifiers on all interactive and visible UI elements
See CLAUDE.md for the full set of coding standards and conventions.