ehmo avatar

Ios Design Guidelines

If you're building iPhone apps and tired of guessing whether your tap targets are big enough or your custom font will break at accessibility sizes, this distills Apple's HIG into enforceable rules with correct and incorrect SwiftUI examples. It covers the critical stuff like 44pt touch targets, safe area handling, why hamburger menus are banned on iOS, and how to make Dynamic Type actually work with custom fonts. The concrete code snippets show you exactly what passes review and what gets flagged. Useful during implementation, code review, or when you inherit a project that ignores half the platform conventions. Saves you from learning HIG violations the hard way through user complaints or rejection.

skills.sh installs
2.1K
GitHub stars
639
last updated
Aug 21, 2026

Install

$ npx -y skills add ehmo/platform-design-skills --skill ios-design-guidelines --agent claude-code

Installs into .claude/skills of the current project.

Files

iOS Design Guidelines for iPhone

Comprehensive rules derived from Apple's Human Interface Guidelines. Apply these when building, reviewing, or refactoring any iPhone app interface.


1. Layout & Safe Areas

Impact: CRITICAL

Rule 1.1: Minimum 44pt Touch Targets

All interactive elements must have a minimum tap target of 44x44 points. This includes buttons, links, toggles, and custom controls.

Correct:

Button("Save") { save() }
    .frame(minWidth: 44, minHeight: 44)

Incorrect:

// 20pt icon with no padding — too small to tap reliably
Button(action: save) {
    Image(systemName: "checkmark")
        .font(.system(size: 20))
}
// Missing .frame(minWidth: 44, minHeight: 44)

Rule 1.2: Respect Safe Areas

Never place interactive or essential content under the status bar, Dynamic Island, or home indicator. Use SwiftUI's automatic safe area handling or UIKit's safeAreaLayoutGuide.

Correct:

struct ContentView: View {
    var body: some View {
        VStack {
            Text("Content")
        }
        // SwiftUI respects safe areas by default
    }
}

Sponsors

Details

Repository
github.com/ehmo/platform-design-skills
Categories
Code Review & Quality, Mobile Development, Design & UI/UX
First seen
Apr 16, 2026

More from ehmo/platform-design-skills

All 8
1aj-geddes avatarrest-api-designaj-geddes/useful-ai-promptsDesign RESTful APIs following best practices for resource modeling, HTTP methods, status codes, versioning, and documentation. Use when creating new APIs, desig2.1Kskills.sh installs
2jwynia avatargodot-best-practicesjwynia/agent-skillsGuide AI agents through Godot 4.x GDScript coding best practices including scene organization, signals, resources, state machines, and performance optimization.2.1Kskills.sh installs
3calm-north avatarbuild-clusterscalm-north/seojuice-skillsBuild a topical authority cluster from a seed keyword or topic. Use when the user asks about topic clusters, content silos, pillar pages, topical authority, con2.1Kskills.sh installs
4zernie avatarstrengthenzernie/vigilesUpgrade a vigiles spec's guidance() rules to enforce() — scan the guidance rules in a CLAUDE.md/AGENTS.md spec and find existing linter rules (ESLint, Ruff, Cli2.1Kskills.sh installs
5aktsmm avatarpowerpoint-automationaktsmm/agent-skillsCreate and edit professional PowerPoint presentations from web articles, blog posts, existing PPTX files, or templates. Use when creating PPTX, converting artic2.1Kskills.sh installs
6calm-north avatarfix-linkingcalm-north/seojuice-skillsDesign or audit internal link structure for a website. Use when the user asks about internal linking, link architecture, orphan pages, PageRank flow, anchor tex2Kskills.sh installs