An offline-first backend, built on the edge.

What it does

• Offline-first sync. Clients hold a local copy and pull changes from a checkpoint; writes land even when the connection doesn't.
• Per-database access rules. Role-based create, read, update and delete rules per collection, enforced server-side.
• End-user auth. Your app's users sign up against your database and carry roles — separate from your own account.
• Runs on Cloudflare. Workers, Durable Objects, D1, R2 and KV, close to wherever your users are.

Quick start

1. Set yourself up in the dashboard

   Everything here is a one-time setup, and the last step gives you the key the code below needs.

   • Register at app.jotabase.com, and confirm your address if you’re asked to.
   • Create a database — a lowercase name, like notes.
   • Open it, go to the API Keys tab, and click + Publishable key.
   • Copy the key now. It’s shown once and never again.

2. Install the client

   npm install @jotabase/client

3. Connect

   Paste the publishable key you just copied. Publishable keys are safe to ship in a frontend bundle.

   import { createClient } from "@jotabase/client";
   
   const jb = createClient({
     url: "https://api.jotabase.com",
     publishableKey: "pk_live_...",
   });

4. Open the database

   Use the name you gave it. Naming one you never created is fine too — the first write brings it into existence.

   const db = jb.db("notes");
   await db.open();          // loads the saved checkpoint

5. Write and sync

   Writes land locally first and are pushed in the background, so they survive a dropped connection.

   await db.put({ id: "note-1", data: { title: "Hello", done: false } });
   
   // Pull everything since the last checkpoint.
   await db.sync();
   const note = await db.get("note-1");
   
   // Re-sync automatically whenever the server changes.
   db.subscribe(() => render());

6. Sign your users in (optional)

   Everything above works with the key alone. Add end-user auth when your users need roles, or rows only they can see.

   const auth = jb.auth("notes");
   const { token } = await auth.signIn({ email, password });
   jb.setToken(token);       // syncs now run as this user, with their roles

Status