Menu / packages / defaults

defaultsas of 9.0.9 · `00a7465a`

https://github.com/sindresorhus/defaults

What it serves, where

Capability	iOS	macOS	watchOS	tvOS	visionOS	Linux	Catalyst
Cloud sync	✓ serves it · confidence 0.85 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → Synchronize values across devices using iCloud; no per-platform gaps recorded. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → Add keys to be automatically synced. `Defaults.iCloud.waitForSyncCompletion` Sources/Defaults/Defaults+iCloud.swift:138 View the line on GitHub → Await completion of synchronization.	✓ serves it · confidence 0.85 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → Synchronize values across devices using iCloud; no per-platform gaps recorded. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → Add keys to be automatically synced. `Defaults.iCloud.waitForSyncCompletion` Sources/Defaults/Defaults+iCloud.swift:138 View the line on GitHub → Await completion of synchronization.	✓ serves it · confidence 0.85 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → Synchronize values across devices using iCloud; no per-platform gaps recorded. Manifest floor watchOS 9 matches NSUbiquitousKeyValueStore availability. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → Add keys to be automatically synced. `Defaults.iCloud.waitForSyncCompletion` Sources/Defaults/Defaults+iCloud.swift:138 View the line on GitHub → Await completion of synchronization.	✓ serves it · confidence 0.85 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → Synchronize values across devices using iCloud; no per-platform gaps recorded. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → Add keys to be automatically synced. `Defaults.iCloud.waitForSyncCompletion` Sources/Defaults/Defaults+iCloud.swift:138 View the line on GitHub → Await completion of synchronization.	✓ serves it · confidence 0.85 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → Synchronize values across devices using iCloud; no per-platform gaps recorded. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → Add keys to be automatically synced. `Defaults.iCloud.waitForSyncCompletion` Sources/Defaults/Defaults+iCloud.swift:138 View the line on GitHub → Await completion of synchronization.	? not verified yet · confidence 0.15 · as of 9.0.9 Package.swift:7 View the line on GitHub → Manifest lists Apple platforms only (not absence evidence). Digest records no os() gaps, so unsupported cannot be claimed; iCloud sync is built on NSUbiquitousKeyValueStore and the file imports Combine/OSLog/UIKit-or-AppKit, making linux presence unverified and very doubtful. readme.md:0 View the line on GitHub → README Compatibility section lists macOS/iOS/tvOS/watchOS/visionOS only; linux never mentioned.	✓ serves it · confidence 0.75 · as of 9.0.9 `Defaults.iCloud` Sources/Defaults/Defaults+iCloud.swift:58 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. `Defaults.iCloud.add` Sources/Defaults/Defaults+iCloud.swift:87 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. Package.swift:7 View the line on GitHub → No explicit macCatalyst floor; Catalyst inherits the .iOS(.v14) floor by SwiftPM default. Confidence lowered accordingly.
Codable persistence	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → Bridge persisting any top-level Codable value; no per-platform gaps recorded. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → Protocol for Codable-based serialization bridges. `Defaults.CodableBridge.serialize` Sources/Defaults/Defaults+Bridge.swift:9 View the line on GitHub → JSON serialization of Codable values.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → Bridge persisting any top-level Codable value; no per-platform gaps recorded. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → Protocol for Codable-based serialization bridges. `Defaults.CodableBridge.serialize` Sources/Defaults/Defaults+Bridge.swift:9 View the line on GitHub → JSON serialization of Codable values.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → Bridge persisting any top-level Codable value; no per-platform gaps recorded. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → Protocol for Codable-based serialization bridges. `Defaults.CodableBridge.serialize` Sources/Defaults/Defaults+Bridge.swift:9 View the line on GitHub → JSON serialization of Codable values.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → Bridge persisting any top-level Codable value; no per-platform gaps recorded. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → Protocol for Codable-based serialization bridges. `Defaults.CodableBridge.serialize` Sources/Defaults/Defaults+Bridge.swift:9 View the line on GitHub → JSON serialization of Codable values.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → Bridge persisting any top-level Codable value; no per-platform gaps recorded. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → Protocol for Codable-based serialization bridges. `Defaults.CodableBridge.serialize` Sources/Defaults/Defaults+Bridge.swift:9 View the line on GitHub → JSON serialization of Codable values.	? not verified yet · confidence 0.20 · as of 9.0.9 Package.swift:7 View the line on GitHub → Manifest lists Apple platforms only (not absence evidence). Digest records no os() gaps, so unsupported cannot be claimed; core target unconditionally imports SwiftUI/Combine (Apple-only frameworks), making linux presence unverified and doubtful. readme.md:0 View the line on GitHub → README Compatibility section lists macOS/iOS/tvOS/watchOS/visionOS only; linux never mentioned.	✓ serves it · confidence 0.80 · as of 9.0.9 `Defaults.TopLevelCodableBridge` Sources/Defaults/Defaults+Bridge.swift:38 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. `Defaults.CodableBridge` Sources/Defaults/Defaults+Protocol.swift:84 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. Package.swift:7 View the line on GitHub → No explicit macCatalyst floor; Catalyst inherits the .iOS(.v14) floor by SwiftPM default. Confidence lowered accordingly.
Key-value storage	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → Root namespace enum; no per-platform gaps recorded in surface digest. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → Strongly-typed key used to access values. `Defaults.subscript` Sources/Defaults/Defaults.swift:30 View the line on GitHub → Access stored values via key subscript.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → Root namespace enum; no per-platform gaps recorded in surface digest. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → Strongly-typed key used to access values. `Defaults.subscript` Sources/Defaults/Defaults.swift:30 View the line on GitHub → Access stored values via key subscript.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → Root namespace enum; no per-platform gaps recorded in surface digest. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → Strongly-typed key used to access values. `Defaults.subscript` Sources/Defaults/Defaults.swift:30 View the line on GitHub → Access stored values via key subscript.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → Root namespace enum; no per-platform gaps recorded in surface digest. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → Strongly-typed key used to access values. `Defaults.subscript` Sources/Defaults/Defaults.swift:30 View the line on GitHub → Access stored values via key subscript.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → Root namespace enum; no per-platform gaps recorded in surface digest. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → Strongly-typed key used to access values. `Defaults.subscript` Sources/Defaults/Defaults.swift:30 View the line on GitHub → Access stored values via key subscript.	? not verified yet · confidence 0.20 · as of 9.0.9 Package.swift:7 View the line on GitHub → Manifest lists Apple platforms only (not absence evidence). Digest records no os() gaps, so unsupported cannot be claimed; core target unconditionally imports SwiftUI/Combine (Apple-only frameworks), making linux presence unverified and doubtful. readme.md:0 View the line on GitHub → README Compatibility section lists macOS/iOS/tvOS/watchOS/visionOS only; linux never mentioned.	✓ serves it · confidence 0.80 · as of 9.0.9 `Defaults` Sources/Defaults/Defaults.swift:4 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. `Defaults.Key` Sources/Defaults/Defaults.swift:92 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. Package.swift:7 View the line on GitHub → No explicit macCatalyst floor; Catalyst inherits the .iOS(.v14) floor by SwiftPM default. Confidence lowered accordingly.
Reactive queries / change tracking	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → Observe a defaults key with a change handler; no per-platform gaps recorded. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → AsyncStream of value updates for a key. `Defaults.publisher` Sources/Defaults/Observation+Combine.swift:89 View the line on GitHub → Combine publisher of KeyChange events.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → Observe a defaults key with a change handler; no per-platform gaps recorded. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → AsyncStream of value updates for a key. `Defaults.publisher` Sources/Defaults/Observation+Combine.swift:89 View the line on GitHub → Combine publisher of KeyChange events.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → Observe a defaults key with a change handler; no per-platform gaps recorded. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → AsyncStream of value updates for a key. `Defaults.publisher` Sources/Defaults/Observation+Combine.swift:89 View the line on GitHub → Combine publisher of KeyChange events.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → Observe a defaults key with a change handler; no per-platform gaps recorded. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → AsyncStream of value updates for a key. `Defaults.publisher` Sources/Defaults/Observation+Combine.swift:89 View the line on GitHub → Combine publisher of KeyChange events.	✓ serves it · confidence 0.90 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → Observe a defaults key with a change handler; no per-platform gaps recorded. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → AsyncStream of value updates for a key. `Defaults.publisher` Sources/Defaults/Observation+Combine.swift:89 View the line on GitHub → Combine publisher of KeyChange events.	? not verified yet · confidence 0.20 · as of 9.0.9 Package.swift:7 View the line on GitHub → Manifest lists Apple platforms only (not absence evidence). Digest records no os() gaps, so unsupported cannot be claimed; Observation+Combine.swift unconditionally imports Combine and the target imports SwiftUI (Apple-only frameworks), making linux presence unverified and doubtful. readme.md:0 View the line on GitHub → README Compatibility section lists macOS/iOS/tvOS/watchOS/visionOS only; linux never mentioned.	✓ serves it · confidence 0.80 · as of 9.0.9 `Defaults.observe` Sources/Defaults/Observation.swift:351 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. `Defaults.updates` Sources/Defaults/Defaults.swift:273 View the line on GitHub → No macCatalyst gap recorded in surface digest; decl resolves present. Package.swift:7 View the line on GitHub → No explicit macCatalyst floor; Catalyst inherits the .iOS(.v14) floor by SwiftPM default. Confidence lowered accordingly.

✓ serves it · ◐ with conditions · ✕ not served (proven) · ? not verified yet — hover any verdict for the receipt, click to pin it

Notes

Cloud sync: Dedicated Defaults.iCloud namespace (add/remove/removeAll/waitForSyncCompletion) plus per-key opt-in via Key.init(iCloud:). Runtime sync additionally requires the app to have the iCloud key-value store entitlement; symbol surface is unconditional, hence confidence 0.85 rather than higher. linux left unknown per absence-evidence rules.

Codable persistence: Codable values are persisted as JSON strings in UserDefaults via TopLevelCodableBridge and related Codable bridges. Surface digest records zero per-platform gaps and zero #if conditions. linux left unknown: no gap-based absence evidence, but sources unconditionally import Apple-only frameworks.

Key-value storage: Core capability: type-safe UserDefaults facade (Defaults.Key + subscript access). Surface digest records zero per-platform gaps and zero #if conditions across all 230 decls. linux left unknown: no gap-based absence evidence exists, but sources unconditionally import Apple-only frameworks.

Reactive queries / change tracking: Three observation surfaces: closure-based Defaults.observe (KVO-backed), AsyncStream-based Defaults.updates, and Combine-based Defaults.publisher. Surface digest records zero per-platform gaps and zero #if conditions. linux left unknown: no gap-based absence evidence, but the Combine/SwiftUI imports are Apple-only.

Badges for your README

Maintainer of defaults? These are yours — verified claims, linked to the receipts. Wrong verdict? That's a fix we want; see contribute.

defaultsas of 9.0.9 · 00a7465a

What it serves, where

Notes

Badges for your README

defaultsas of 9.0.9 · `00a7465a`