Agent skill · design visual · aiskillstore
swiftui-ui-patterns
Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.
Why this skill is useful
Provides specific patterns and best practices for building SwiftUI components that the AI wouldn't reliably generate on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
SwiftUI UI Patterns Quick start Choose a track based on your goal: Existing project Identify the feature or screen and the primary interaction model (list, detail, editor, settings, tabbed). Find a nearby example in the repo with rg "TabView\(" or similar, then read the closest SwiftUI view. Apply local conventions: prefer SwiftUI-native state, keep state local when possible, and use environment injection for shared dependencies. Choose the relevant component reference from references/components-index.md and follow its guidance. Build the view with small, focused subviews and SwiftUI-native data flow. New project scaffolding Start with references/app-scaffolding-wiring.md to wire TabView + NavigationStack + sheets. Add a minimal AppTab and RouterPath based on the provided skeletons. Choose the next component reference based on the UI you need first (TabView, NavigationStack, Sheets). Expand the route and sheet enums as new screens are added. General rules to follow Use modern SwiftUI state (@State, @Binding, @Observable, @Environment) and avoid unnecessary view models. Prefer composition; keep views small and focused. Use async/await with .task and explicit loading/error states. Maintain existing legacy patterns only when editing legacy files. Follow the project's formatter and style guide. Sheets: Prefer .sheet(item:) over .sheet(isPresented:) when state represents a selected model. Avoid if let inside a sheet body. Sheets should own their actions and call dismiss() internally instead of forwarding onCancel/onConfirm closures. Workflow for a new SwiftUI view 1. Define the view's state and its ownership location. 2. Identify dependencies to inject via @Environment. 3. Sketch the view hierarchy and extract repeated parts into subviews. 4. Implement async loading with .task and explicit state enum if needed. 5. Add accessibility labels or identifiers when the UI is interactive. 6. Validate with a build and update usage callsites if needed. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/swiftui-ui-patterns