Atlas Desk storage, search, files, and sync
Atlas Desk is a local-first research organizer for quick capture, connected documents, attachments, search, and deliberate export across iPhone, iPad, and Mac. Its design favors durable ownership and retrieval over feature count.
Product decision
How can durable local truth, full-text search, attachments, migrations, and CloudKit sharing coexist?
The smallest useful vertical slice is concrete: Commit locally first, append an outbox operation, update the search index, and transfer immutable attachment revisions.
Boundaries that keep the design honest
- Keep document identity and revision rules in framework-neutral types that can be tested without an application target.
- Treat phone, tablet, and Mac interfaces as adapters to the same tasks while respecting each platform’s navigation and input conventions.
- Make local persistence authoritative; search, files, cloud sharing, and interface projections derive from committed document state.
- Record migration, conflict, accessibility, large-library, and interruption evidence before calling the release ready.
- Avoid this failure: Uploading files or synchronizing transient view state before the local document transaction is durable.
Release evidence
The product model was reviewed, but no Atlas Desk app target, SwiftUI scene, SwiftData store, CloudKit container, macOS window, migration, or device journey was built or executed.
This chapter is an architecture and review artifact. Apple SDK behavior still needs the matching Xcode target, Simulator where representative, configured account or entitlement where required, and physical-device evidence for hardware or field behavior. The browser Swift runner proves none of those Apple platform surfaces.
Series navigation
- Previous: Part 113: Atlas Desk SwiftUI phone and tablet app
- Next: Part 115: Atlas Desk macOS product design
- Series index: Zero to iOS Hero