swiftdata-guide

What problem does it solve?

SwiftData models require strict thread affinity and must be accessed on the MainActor to avoid data races and context errors. This guide provides practices to prevent crashes and ensure safe, scalable data management in Swift-based apps.

Core Features & Use Cases

• Enforces MainActor usage for all SwiftData models to prevent cross-thread mutations.
• Demonstrates a three-phase architecture (extract identifiers, fetch updates concurrently, apply updates) for safe data synchronization.
• Includes representative model examples (Vault, Coin, etc.) and strategies for batch upserts and relationships to support large, evolving datasets.

Quick Start

Apply the three-phase pattern to safely extract identifiers on the MainActor, fetch updates concurrently with value types, then apply and save updates on the MainActor using Storage.shared.save().