v0.1.0

Core

• Breaking: Updated storage format version to 2 (will create new database files)

• Breaking: Changed schema.key to storeId #175

  // before
  const schema = makeSchema({ tables, mutations, key: 'my-app-id' })
  // ...
  <LiveStoreProvider schema={schema} storeId="my-app-id">
  
  // after
  const schema = makeSchema({ tables, mutations })
  // ...
  <LiveStoreProvider schema={schema} storeId="my-app-id">

• Breaking: Removed useLocalId / getLocalId in favour of store.sessionId / SessionIdSymbol

• Upgraded dependencies

  • If you're using effect in your project, make sure to install version 3.10.x
    • Note the new version of effect now includes Schema directly, so @effect/schema is no longer needed as a separate dependency. (See Effect blog post.)

• Breaking: Moved effect-db-schema to @livestore/db-schema (mostly an internal change unless you're using the package directly)

• Breaking: Adjusted boot signature when creating a store to now pass in a Store instead of a helper database object

  <LiveStoreProvider
    schema={schema}
    boot={(store) => store.mutate(mutations.addTodo({ id: cuid(), text: 'Make coffee' }))}
    adapter={adapter}
    batchUpdates={batchUpdates}
  >
    // ...
  </LiveStoreProvider>

• Prepared the foundations for the upcoming rebase sync protocol

  • Implementation detail: New event id strategy (uses a global event id integer sequence number and each event also keeps a reference to its parent event id)

React integration

• Breaking: The React integration has been moved into a new separate package: @livestore/react (before: @livestore/livestore/react)

• Breaking: Renamed useTemporaryQuery to useScopedQuery

Web adapter

• Devtools address is now automatically logged during development making connecting easier.
  

• Breaking: Changed syncing adapter interface:

  const adapter = makeAdapter({
    storage: { type: 'opfs' },
    worker: LiveStoreWorker,
    sharedWorker: LiveStoreSharedWorker,
    syncBackend: {
      type: 'cf',
      url: import.meta.env.VITE_LIVESTORE_SYNC_URL,
      roomId: `todomvc_${appId}`,
    },
  })

Expo adapter

• Updated to Expo SDK 52 (52.0.0-preview.23)

• Fix: Crash in release builds #206

• Fix: Disable devtools in release builds #205

Devtools

• Feature: New SQLite query playground
  

• Fix: Databrowser no longer crashes when removing tables #189

• Breaking (in combination with web adapter): Removed _devtools.html in favour of @livestore/devtools-vite. #192

  • Replace @livestore/devtools-react with @livestore/devtools-vite in your package.json

  • Delete _devtools.html if it exists

  • Add the following to your vite.config.ts:

    import { livestoreDevtoolsPlugin } from '@livestore/devtools-vite'
    
    export default defineConfig({
      // ...
      plugins: [
        // ...
        livestoreDevtoolsPlugin({ schemaPath: './src/db/schema/index.ts' }),
        // ...
      ],
    })

Misc

• Improved CI setup #179 #166