PILLAR // 01
Zero Spinners (Instant Latency)
All reads and writes occur directly against on-device embedded memory or storage. User interactions never await a remote round-trip HTTP request or cloud API ack.
Cloud-first architectures made computing fragile, rental-based, and reliant on perpetual connectivity. Local-first software restores data sovereignty: applications run instantaneously against on-device storage, treating the network as an asynchronous gossip mesh rather than a single point of failure.
Foundational Pillars
Derived from the seminal 2019 Ink & Switch research, these core principles define software that prioritizes user sovereignty without sacrificing modern collaboration.
PILLAR // 01
All reads and writes occur directly against on-device embedded memory or storage. User interactions never await a remote round-trip HTTP request or cloud API ack.
PILLAR // 02
Changes propagate across phones, laptops, and tablets automatically through mathematical conflict-free synchronization, resolving concurrent mutations deterministically.
PILLAR // 03
Offline is not an error condition or an edge case; it is the default baseline state. The entire application remains completely functional in airplanes, subway tunnels, or off-grid retreats.
PILLAR // 04
Real-time multi-user editing occurs with low latency over WebRTC, local wireless meshes, or lightweight websocket relays, supporting rich cursor presence and document merges.
PILLAR // 05
Data survives company shutdowns, cloud vendor insolvencies, and pricing tier migrations. If the developer vanishes tomorrow, your data and software continue executing indefinitely.
PILLAR // 06
Data on the central sync relay is an opaque encrypted byte blob. Server operators cannot train models on your journal entries, monitor keystrokes, or inspect private schemas.
Users retain absolute authority to inspect, copy, backup, script, export, or permanently delete their data without requesting permission or encountering rate limits from proprietary cloud gatekeepers.
Architectural Contrast
Comparing the architectural assumptions and failure modes of traditional REST/GraphQL single-source systems against distributed local-first topologies.
| Evaluation Vector | Traditional Cloud-Centric Architecture | Local-First Sovereign Architecture |
|---|---|---|
| Primary Source of Truth | Remote Postgres/MySQL database hosted in cloud region | Local embedded database (SQLite/IndexedDB) on device |
| Network Latency on Mutation | 120ms – 850ms network round-trip blocking UI | < 5ms local transaction write directly to disk |
| Offline Capability | Limited read cache; mutations disabled or volatile | Full read, write, filter, search, and update capabilities |
| Conflict Resolution | Central database locks, SERIALIZABLE transactions, or LWW | Mathematical CRDTs, Merkle Search Trees, Rebase logs |
| Sync Wire Protocol | Stateful REST, GraphQL mutations, RPC endpoints | Deterministic byte patches, log deltas, event streams |
| System Failure Mode | Cloud outage renders all global clients inoperable | Cloud outage pauses cross-peer sync; local apps run fine |
STAGE 01
User acts in UI. State modifies local reactive store and immediately writes to local embedded SQLite database.
STAGE 02
The embedded engine encodes the operation into a deterministic byte patch with a Lamport clock timestamp.
STAGE 03
Deltas enqueue into an outbox buffer and broadcast across available WebRTC peers or zero-knowledge relay websockets.
STAGE 04
Remote nodes receive deltas and merge via commutative CRDT rules without requiring locks or server coordination.