SwiftUI Design Principles
Spacing, typography, colour and layout rules for SwiftUI apps and WidgetKit widgets that look polished and native. By Arjit Jaiswal.
View on GitHub ↗- Stars
- ★ 32
- Last commit
- 16 Mar 2026
- Maintenance
- Slowing
- Licence
- MIT
- Category
- Agent Skills
- GitHub
- arjitj2/swiftui-design-principles
Overview
An agent skill that encodes design principles for building polished, native-feeling SwiftUI apps and widgets. It was put together by comparing well-built apps with poorly built ones, and steers agents away from arbitrary spacing, too many font sizes and hardcoded colours. It switches on when creating or changing SwiftUI views or WidgetKit widgets.
Features
- A base-4/8 spacing system
- Weight-based typography hierarchy
- System semantic colours instead of hardcoded values
- Proportional component sizing
- Native grouped content and NavigationStack usage
- Widget implementation guidance
Requirements
The source doesn't list any requirements, so check the project's own docs before you install.
Install
Install with the skills CLI
npx skills add arjitj2/swiftui-design-principles
Works with
Listed in
- github.com/arjitj2/swiftui-design-principles
- raw.githubusercontent.com/arjitj2/swiftui-design-principles/HEAD/README.md
- raw.githubusercontent.com/arjitj2/swiftui-design-principles/HEAD/SKILL.md
Read the code before you install anything. SwiftAgents doesn't review or endorse the tools listed here. Active: a commit in the last 90 days. Slowing: last commit within the past year. Stale: older than a year, or archived.
More in this category
App Store Screenshots
Sets up a small Next.js editor for making framed App Store and Google Play screenshots across Apple devices and locales.
SwiftUI Pro
Paul Hudson's SwiftUI skill, aimed at the mistakes models often make with navigation, layout, state, VoiceOver and deprecated APIs.
Dimillian Skills
Thomas Ricouard's skill pack: SwiftUI performance audits, Liquid Glass, view refactors, Swift concurrency fixes, App Store release notes and simulator debugging.