cloudkit-macos

What problem does it solve?

Implementing reliable, production-ready CloudKit integration on macOS presents unique challenges, including macOS-specific push reliability issues, sandbox entitlement requirements, conflict resolution for multi-window editing, and proper coordination of iCloud Drive documents. This Skill eliminates the need to piece together fragmented documentation by providing end-to-end, macOS-specific guidance for all CloudKit use cases.

Core Features & Use Cases

• Full CloudKit API Coverage: Detailed guidance for CKContainer, CKRecord, CKQuery, subscriptions, and CKSyncEngine tailored to macOS behavior.
• Core Data Sync: Step-by-step setup for NSPersistentCloudKitContainer with configurable merge policies for conflict-free cross-device data sync.
• iCloud Drive Document Sync: Implementation patterns for NSFileCoordinator and NSFilePresenter to handle coordinated document access and conflict resolution.
• macOS-Specific Guardrails: Workarounds for known macOS push delivery bugs, entitlement configuration steps, and sandbox requirements to avoid common launch and runtime failures. Use Case: A macOS note-taking app can use this Skill to implement cross-device note sync with automatic conflict merging, offline support, and iCloud Drive document storage.

Quick Start

Use the cloudkit-macos skill to implement cross-device data sync for your macOS app using CloudKit and NSPersistentCloudKitContainer with proper conflict resolution and push handling.