⚡ What Is zeno-db?

zeno-db is a tiny but powerful library that handles client-side IndexedDB storage and syncs with a Postgres database on the backend — all in real time via WebSockets.

It's perfect for:

  • 📝 Note-taking and journaling apps
  • 📦 Inventory or POS systems
  • 🧑‍🌾 Field apps in low-connectivity areas
  • 🧠 Any local-first, collaborative app

🧩 Key Features

  • ✅ Offline-first: Use IndexedDB directly in the browser
  • 🔁 Syncs to a remote PostgreSQL backend
  • ⚡ Real-time updates using WebSockets
  • 🧼 Zero dependencies
  • 👷 Built with TypeScript

You get the speed of local storage with the reliability of Postgres, all wrapped in a lightweight sync layer.

🔧 Basic Setup

Install with:

npm install zeno-db

Example usage:

import { ZenoClient } from 'zeno-db';

const db = new ZenoClient({
  serverUrl: 'wss://myapp.com/socket',
  database: 'my_local_db',
});

The client stores data locally, and when the network is available, it syncs everything seamlessly to your server.

🚧 It’s Beta — But Very Active

The project is in active development, and the authors are upfront: expect occasional breaking changes and limited docs (for now).

But if you’re an early adopter or building prototypes, it’s a fantastic time to explore.

🔄 How Does It Compare?

enter image description here

🧠 Final Thoughts

zeno-db is a promising, low-overhead alternative for anyone building a local-first experience on top of a familiar Postgres stack.

If you’re tired of choosing between complex sync engines or vendor lock-in, give this a shot.

👀 What’s Next?

  • 🔗 NPM: zeno-db

  • 🧪 Test it in your next PWA or internal tool

Thank you all