swiftui-design-principles

Enforce SwiftUI and WidgetKit design principles for spacing, typography, and color.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/arjitj2/arjit-skills --skill swiftui-design-principles-arjitj2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: swiftui-design-principles
Source: https://github.com/arjitj2/arjit-skills/tree/main/skills/swiftui-design-principles
Command: npx skills add https://github.com/arjitj2/arjit-skills --skill swiftui-design-principles-arjitj2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you avoid the common visual mistakes that make SwiftUI apps and widgets feel inconsistent, overly decorated, or “AI-generated.” It gives you a clear design system for spacing, typography, color, sizing, navigation, and WidgetKit patterns so interfaces look refined and native.

Core Features & Use Cases

  • Spacing discipline: Uses a base-4/base-8 grid to eliminate arbitrary padding and spacing values.
  • Typography hierarchy: Keeps text readable and elegant with a small, consistent type scale and weight-based hierarchy.
  • Semantic colors and native components: Replaces hardcoded opacities, oversized custom cards, and manual widget drawings with system colors, NavigationStack, Gauge, and other Apple-native patterns.
  • Use case: Apply it when designing a new SwiftUI screen, refining a widget timeline view, or reviewing an existing interface that feels visually “off.”

Quick Start

Use the swiftui-design-principles skill to review this SwiftUI screen and rewrite it so the spacing, typography, colors, and widget patterns follow the skill’s design rules.

Frequently Asked Questions about swiftui-design-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix inconsistent spacing and typography in SwiftUI views?

To fix inconsistent SwiftUI spacing and typography, apply a constrained base-4/base-8 spacing grid and a small, weight-based type scale. This eliminates arbitrary padding values and ensures text remains readable, elegant, and visually consistent across native iOS interfaces.

What makes a SwiftUI app look native instead of AI-generated?

A SwiftUI app looks native by replacing hardcoded opacities and oversized custom cards with semantic system colors and native components like NavigationStack and Gauge. Adhering to proportional sizing and strict design rules prevents the inconsistent, overly decorated look of AI-generated interfaces.

How do I design WidgetKit interfaces that share data with my iOS app?

Design WidgetKit interfaces that share data with your iOS app by using shared app-widget data models. This approach enforces visual consistency and allows your native Apple UI layouts to maintain production quality while synchronizing information seamlessly between the main app and the widget timeline view.

Can I use this design system to review an existing SwiftUI screen that feels visually off?

Yes, you can review an existing SwiftUI screen that feels visually off by applying pre-ship validation rules for spacing, color, sizing, and navigation. This process identifies visual mistakes and rewrites the interface to follow a polished, constrained design system.

Does SwiftUI require semantic system colors to avoid overly decorated interfaces?

Yes, SwiftUI requires semantic system colors to avoid overly decorated interfaces. Replacing manual hardcoded opacities and custom widget drawings with system colors ensures your native UI adapts properly to light and dark modes while maintaining visual consistency.