Interactive graph

Local-first Software

Created Aug 3, 2026, 1:34 AM · Updated Aug 3, 2026, 1:34 AM

Local-first means the device holds the truth; sync is optional icing - backup should behave the same way.

Key Concept

  • Truth lives on the device first; cloud sync is backup, not the vault.
  • Choose what is public, what stays private, and what gets encrypted before it leaves the room.
  • Sync should merge edits without picking last-write-wins by clock alone.

Level 1 - Recognize

Local-first software keeps the master copy on your device and treats cloud sync as backup, not the vault.

Level 2 - Explain

Like keeping your diary in your room and photocopying it for safety, your phone or computer owns the real file first.

Level 3 - Use

Pick tools that work offline with full features - sync is insurance, not the place you crawl to after an outage.

Level 4 - Connect

If the service vanishes, your notes survive on the device - cloud-only stacks fail when the tenant changes the rules or the network drops.

Level 5 - Create

Extend local-first into Building a Personal API and Digital Minimalism - read and write without begging a server.

Examples

  • If the phone dies mid-grocery run, the list on the fridge still works.
  • Grandma's recipe cards live in the kitchen drawer - not an app that might vanish.

Note Relationships

RelationshipWikilinkReason
alternativeBuilding a Personal APILocal files vs push API when boring export wins
contradictsDrafting in Publicwhen private-first truth beats publishing before I am ready
extendsPKMYour device holds the truth and sync is icing - that is how a brain backup should behave
Why I Still Keep a Desktop or Laptop

Why I Still Keep a Desktop or Laptop

Every couple of years someone goes mobile-only. I keep a laptop because real work happens faster there - upright, keyboard, full apps - not because I'm lending gear.

RSS Feeds - What I Wish I'd Done Sooner

RSS Feeds - What I Wish I'd Done Sooner

I figured RSS quietly died around 2010. A friend pointed out it never actually did - it just stopped being trendy. Two weeks of using it later, I was a convert.

Why I Prefer the Google Ecosystem Over Apple

Why I Prefer the Google Ecosystem Over Apple

I run a MacBook Pro M4 and an 11th-gen iPad - and I still live in Google's ecosystem. One Google account glues my Mac, Android, Linux, and TV together. No compelling reason to add an iPhone or Apple Watch on top.

Sustainable Online Publishing

Sustainable Online Publishing

I already decided to own my site. This is how I keep publishing without treating social as my archive - domain, Git, push, share.

The Mouse Wheel Click: One Button, Three Operating Systems

The Mouse Wheel Click: One Button, Three Operating Systems

Most people right-click every link to open a new tab. There's a faster button under their finger - same gesture on every OS, and almost nobody uses it.

How I Built JoRap Notes: After Losing PHP Hosting

How I Built JoRap Notes: After Losing PHP Hosting

I lost my old PHP hosting and a chunk of my work. A weekend later I landed on Hugo + GitHub + Cloudflare Pages - faster and better than what I was paying for.

Random Note

One garden note picked at random - shuffle for a new pairing with this note.

AI prompt

Loading…