Contacts & ContactsUI (iOS)

Read, write, and pick the user's contacts. Contacts is the data layer (CNContactStore, CNContact); ContactsUI is the system UI (CNContactPickerViewController, CNContactViewController, ContactAccessButton).

• KMP boundary: contacts are iOS-only Apple API. Expose a commonMain interface ContactsGateway and bind a CNContactStore-backed actual in iosMain — never let shared code depend on CN* types. See expect-actual / android-skills:kmp-boundaries.
• Wrapping UIKit controllers in SwiftUI: UIViewControllerRepresentable + a Coordinator delegate — see swiftui-uikit-interop. Full wrappers in references/contactsui.md.
• Privacy: requires NSContactsUsageDescription in Info.plist (app crashes on request without it). Reconcile the privacy manifest with app-store-review.

Contents