my-tanstack-db-collections

Monorepo for event-sourced-collection — a local-first, event-sourced database on TanStack DB — plus a reference example app.

Packages

Apps

Quick start

pnpm install
pnpm --filter event-sourced-collection build
pnpm --filter example dev

Open http://localhost:3091.

Usage (browser)

Recommended setup — one call, platform deps stay in your app via load:

import { createBrowserEventSourcedDB } from "event-sourced-collection/browser";

const { ensureDb, db } = createBrowserEventSourcedDB({
  databaseName: "my-app.sqlite",
  collections: {
    todos: { getKey: (todo: Todo) => todo.id },
  },
  sync: { pushEvents, pullEvents },
  load: async () => {
    const { createCollection } = await import("@tanstack/react-db");
    const platform = await import("@tanstack/browser-db-sqlite-persistence");
    return { ...platform, createCollection };
  },
});

export { db, ensureDb };

Call ensureDb() once when your app mounts, then use db.collections.* and db.sync() as normal.

Full guide: packages/event-sourced-collection/README.md

Runnable example app: apps/example/README.md

Scripts

pnpm build          # build all packages/apps
pnpm dev            # dev all (turbo)
pnpm test           # run tests (event-sourced-collection)
pnpm check-types    # typecheck all

Build or test a single package:

pnpm --filter event-sourced-collection test
pnpm --filter example check-types