← Back to articles

Local-First Sync Architecture

How we built Golden Day to work offline and sync seamlessly

Golden Day's sync architecture is what makes it special. It works perfectly offline, and when you do go online, it syncs seamlessly across devices. But how does it work?

Conflict Resolution

The hardest part of local-first sync is handling conflicts. What happens when you edit a bookmark on your phone while offline, and also edit it on your laptop? We use operational transformation to merge changes intelligently.

Sync Strategy

We use a hybrid approach: your data lives locally first, and syncs to an optional server when online. The server is just a relay—it doesn't store your data permanently, and you can even run your own server if you want.