boutique-store

Boutique Store

Use this skill when you need to persist arrays of items using Boutique's Store, build @Observable data controllers with @Stored, chain store operations, or monitor granular store events.

Prerequisites

• Boutique added as a dependency via Swift Package Manager.
• Models conform to Codable, Sendable, and Identifiable (recommended).
• iOS 17+ / macOS 14+ deployment target.
• Swift 6.2+ (Boutique uses @MainActor default isolation).

Item Requirements

All items stored in a Store must conform to StorableItem, which is a typealias for Codable & Sendable.

struct Note: Codable, Sendable, Identifiable {
    let id: String
    let text: String
    let createdAt: Date
}

Creating a Store

Shortest form (Identifiable with String ID)

When your item conforms to Identifiable with ID == String, the cacheIdentifier is inferred automatically.

let store = Store<Note>(
    storage: SQLiteStorageEngine.default(appendingPath: "Notes")
)

Identifiable with UUID ID

When ID == UUID, the store automatically converts to a string identifier.

struct Photo: Codable, Sendable, Identifiable {
    let id: UUID
    let url: URL
}

let store = Store<Photo>(
    storage: SQLiteStorageEngine.default(appendingPath: "Photos")
)

Custom cache identifier

For items that are not Identifiable or need a custom key, provide a KeyPath<Item, String>.

struct Bookmark: Codable, Sendable {
    let url: URL
    let title: String
}

let store = Store<Bookmark>(
    storage: SQLiteStorageEngine.default(appendingPath: "Bookmarks"),
    cacheIdentifier: \.url.absoluteString
)

Custom storage directory

let store = Store<Note>(
    storage: SQLiteStorageEngine(directory: .documents(appendingPath: "Notes"))!
)

Async initialization (items loaded before returning)

let store = try await Store<Note>(
    storage: SQLiteStorageEngine.default(appendingPath: "Notes")
)
// store.items is already populated here