Initial commit

skills/ios-swift-expert/references/apple-guidelines.md

@@ -0,0 +1,55 @@
+# Apple Guidelines & Resources
+
+Authoritative sources for iOS and macOS development best practices.
+
+## Official Documentation
+
+- **Apple Developer Documentation**: https://developer.apple.com/documentation/
+- **Swift Language Guide**: https://docs.swift.org/swift-book/
+- **Human Interface Guidelines**: https://developer.apple.com/design/human-interface-guidelines/
+- **Swift API Design Guidelines**: https://www.swift.org/documentation/api-design-guidelines/
+- **WWDC Videos**: https://developer.apple.com/videos/
+
+## 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