Local-First · Basics
What Is Local-First Software? A Plain-English Guide
Local-first software keeps your data on your device and treats the network as an enhancement. What it means, the seven ideals behind it, and honest trade-offs.
TL;DR: Local-first software stores your data on your own device first, so the app works instantly and offline — the network is used for sync and collaboration, not as a requirement. The term comes from a 2019 Ink & Switch essay by Martin Kleppmann and colleagues.
You've probably felt the problem even if you've never heard the term. Your notes app shows a spinner on a train. A tool you relied on gets acquired and shut down, and your data goes with it. Local-first software is a response to that: apps where your data lives on your device first, and the network is an enhancement — useful for sync and sharing, but never required just to open your own work.
This post explains what local-first actually means, where the idea comes from, and — honestly — what it costs.
What local-first software actually means
In a typical cloud app, the "real" copy of your data sits on the company's server. Your device holds a temporary view of it. Every edit is a request to a computer you don't control, which is why the app stalls when your connection does.
Local-first software flips that. The primary copy lives on your device — usually as ordinary files or a local database. The app reads and writes locally, so it's fast and works offline by default. When a network is available, it syncs changes in the background.
That's different from two things it often gets confused with:
| Approach | Where the real data lives | Offline behavior |
|---|---|---|
| Cloud-first | The company's server | Limited or none |
| Cloud-first + offline mode | Still the server | A fallback; features degrade |
| Local-first | Your device | Everything works; sync catches up later |
"Offline mode" is a patch on a cloud architecture: the server is still the source of truth, and the app is nervous whenever it can't reach it. Local-first isn't a mode. It's the architecture.
The seven ideals of local-first software
The term comes from a 2019 essay titled "Local-first software" by Martin Kleppmann, Adam Wiggins, Peter van Hardenberg and Mark McGranaghan, published by the research lab Ink & Switch. It's worth reading in full, but its core is seven ideals that local-first apps should aim for:
- No spinners. Your work is at your fingertips — every action is instant because it happens on your device.
- Your work isn't trapped on one device. Local-first still wants multi-device access; it just doesn't route it through a mandatory server.
- The network is optional. You can work for days offline and sync when you reconnect.
- Seamless collaboration. Working with others should still be possible — the hardest ideal, and the essay admits it.
- The Long Now. Your data should outlive the app and the company. Files you can open in decades, not a database behind a dead login page.
- Security and privacy by default. Data that stays on your device can't leak from someone else's server.
- You retain ultimate ownership and control. No one can lock you out of your own notes, raise the price of access, or delete your account.
No app hits all seven perfectly. The ideals are a direction, not a checklist — a way to ask "who really controls this data?" about any tool you adopt.
Why local-first matters for notes
You can live with a cloud-first to-do app; tasks expire. Notes don't. A note system is something you hope to still be using in twenty years, which makes three local-first properties unusually valuable:
- Longevity. Companies pivot, get acquired, and shut down. If your notes are local files, the worst case is switching apps — not losing a decade of thinking. This matters even more if you're building a second brain meant to compound over years.
- Privacy. Notes are where you draft the things you're not ready to say out loud. Local-first means they aren't sitting on a server by default, readable by whoever has access to it.
- Speed. Capture only works when it's frictionless. An app that opens instantly and never blocks on the network is one you'll actually use — and a fast tool makes it far easier to keep your notes organized instead of dumping them somewhere "temporary."
It's no accident that much of the interest in local-first comes from the note-taking world — it's a running theme when people compare Notion and Obsidian, and a common reason people go looking for alternatives to Notion in the first place.
The honest trade-offs
Local-first isn't free, and you should distrust anyone who says otherwise.
- Sync is genuinely hard. When two devices edit the same note offline, something has to merge the changes. Good local-first apps handle this automatically; bad ones make you pick a winner and lose an edit. This is an active research area (the same Ink & Switch group works on the underlying tech), and quality varies a lot between apps.
- Collaboration is harder. Cloud apps get real-time editing almost for free because everyone talks to one server. Local-first apps have to earn it, and some simply don't offer it.
- Backups become your job — partly. If the only copy is on your laptop, your laptop is now a single point of failure. Optional sync or your own backup routine covers this, but "optional" means you have to opt in.
For most personal knowledge work, these are good trades: you accept some sync complexity in exchange for speed, privacy, and data that outlives any company. For heavily collaborative team documents, a cloud-first tool may honestly serve you better today.
If you want to try the model, Stacy is built this way — a local-first workspace where notes live on your device and sync is optional, with a Notion-style block editor on top.
The short version
Local-first software keeps the primary copy of your data on your device, works fully offline, and treats the network as an enhancement for sync and collaboration. The idea was named and defined by Kleppmann and colleagues at Ink & Switch in 2019, and it matters most for data you want to keep for decades — which is exactly what your notes are.
Frequently asked questions
What is local-first software in simple terms?
It's software where the primary copy of your data lives on your own device, not on a company's server. The app works fully offline, opens instantly, and uses the internet only as an enhancement — for syncing between devices or collaborating with others.
Is local-first the same as offline mode?
No. Offline mode is a fallback bolted onto a cloud app — the server still holds the real copy of your data, and features often degrade when you disconnect. In local-first software the device holds the real copy, so nothing degrades offline.
Where does the term local-first come from?
It was coined in a 2019 essay called Local-first software by Martin Kleppmann, Adam Wiggins, Peter van Hardenberg and Mark McGranaghan, published by the research lab Ink & Switch. The essay defines seven ideals that local-first apps should aim for.
What are the downsides of local-first software?
Sync is genuinely hard to build well, so conflicts can happen when the same note is edited on two devices. Real-time collaboration is harder than in cloud apps, and you take on some responsibility for backups. Good local-first apps mitigate all three, but the trade-offs are real.
Why does local-first matter for note-taking apps specifically?
Notes are long-lived and personal. Local-first means your notes open instantly, stay readable even if the company disappears, and aren't sitting on someone else's server by default. For a system you hope to use for decades, those properties matter more than in most software.