Files
gh-sjungling-claude-plugins…/skills/ios-swift-expert/references/apple-guidelines.md
2025-11-30 08:57:43 +08:00

1.6 KiB

Apple Guidelines & Resources

Authoritative sources for iOS and macOS development best practices.

Official Documentation

Human Interface Guidelines

Follow platform conventions for:

  • Navigation patterns and controls
  • Interactions and gestures
  • Dynamic Type for accessibility
  • Privacy preferences handling
  • Multitasking and background modes

Swift API Design Guidelines

Key principles:

  • Clarity at the point of use
  • Naming that makes code read like prose
  • Prefer methods and properties over free functions
  • Omit needless words
  • Compensate for weak type information

Privacy & Security

Best practices:

  • Request permissions with clear purpose strings
  • Handle user data securely (Keychain for credentials)
  • Use App Transport Security (HTTPS by default)
  • Implement Face ID/Touch ID for sensitive operations
  • Follow privacy manifests requirements (iOS 17+)

Accessibility

Requirements:

  • Add accessibility labels and hints
  • Support VoiceOver navigation
  • Test with Accessibility Inspector
  • Support Dynamic Type and larger text sizes
  • Ensure sufficient color contrast

Localization

Guidelines:

  • Use NSLocalizedString for user-facing text
  • Support right-to-left languages
  • Externalize date/number formatting
  • Test with pseudo-localization