{
  "markdown": "# SwiftUI Design Principles\n\nAn agent skill that encodes design principles for building polished, native-feeling SwiftUI apps and WidgetKit widgets.\n\nDerived from a side-by-side comparison of two iOS apps built with AI coding tools — one that looked and felt polished, and one where the margins, spacing, text sizes, and widgets were just *off*. The patterns here represent the concrete differences between the two.\n\n## Install\n\n```bash\nnpx skills add arjitj2/swiftui-design-principles\n```\n\n## What it covers\n\n| # | Principle | What it prevents |\n|---|-----------|-----------------|\n| 1 | Spacing system (base-4/8 grid) | Arbitrary padding values like 26, 34, 36pt |\n| 2 | Typography hierarchy (weight-based) | 7+ font sizes with no clear system |\n| 3 | System semantic colors | Hardcoded `Color.white.opacity(0.42)` everywhere |\n| 4 | Proportional component sizing | 260pt progress rings, mismatched stroke widths |\n| 5 | Native grouped content | Over-engineered gradient cards with 22pt corners |\n| 6 | NavigationStack usage | Bare ZStack layouts with manual titles |\n| 7 | WidgetKit native components | Manual circle drawing instead of Gauge |\n| 8 | Interactive elements | Hidden Toggle labels, low-contrast tints |\n| 9 | Shared data models | Duplicated logic between app and widget |\n| 10 | Pre-ship checklist | Quick verification before shipping |\n\n## When it activates\n\nThe skill triggers when creating or modifying:\n- SwiftUI views\n- iOS widgets (WidgetKit)\n- Any native Apple UI\n\n## Compatible agents\n\nWorks with Claude Code, Cursor, Cline, GitHub Copilot, Windsurf, and any agent that supports the [Agent Skills](https://skills.sh) format.\n\n## License\n\nMIT\n",
  "bytes": 1666,
  "sha": "f30860f1a794d22fbcd3d48d98d6c0a8f5c43f1287859ff017e8380c6ea47eed",
  "repo_slug": "arjitj2/swiftui-design-principles",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_arjitj2_swiftui_design_principles_swiftu_3576aa8e/readme"
}