@livestore/livestore 0.4.0-dev.20 → 0.4.0-dev.22

package/docs/index.md

@@ -2,19 +2,19 @@
 
 <CardGrid>
   <LinkCard
-    title="Getting Started"
+    title="Getting started"
     description="Learn how to get started with LiveStore"
     href="/getting-started/react-web"
+  />
+    <LinkCard
+    title="Introduction"
+    description="Introduction to LiveStore"
+    href="/overview/introduction"
   />
   <LinkCard
     title="Evaluation"
     description="Evaluate LiveStore for your use case"
-    href="/evaluation/design-decisions"
-  />
-  <LinkCard
-    title="Reference"
-    description="Reference documentation for LiveStore"
-    href="/reference/concepts"
+    href="/understanding-livestore/design-decisions"
   />
   <LinkCard
     title="Patterns"
@@ -29,13 +29,13 @@
   <LinkCard
     title="Contributing"
     description="Contributing to LiveStore"
-    href="/contributing/contributing"
+    href="/sustainable-open-source/contributing/info"
   />
 </CardGrid>
 
 ## State of the documentation
 
-Please note that the documentation is still work in progress with many parts missing and often only containing notes/bullet points.
+Please note that the documentation is still work in progress. Please [leave feedback](https://github.com/livestorejs/livestore/issues) if you didn't find the information you were looking for and [consider contributing](/sustainable-open-source/contributing/docs) yourself.
 
 ### Docs for LLMs
 
@@ -43,103 +43,147 @@ We support the [llms.txt](https://llmstxt.org/) convention for making documentat
 
 Currently, we have the following root-level files:
 
-- [Code of Conduct](/misc/CODE_OF_CONDUCT/): Our code of conduct for the LiveStore community.
-- [Community](/misc/community/)
-- [Troubleshooting](/misc/troubleshooting/): Common issues in apps using LiveStore and possible solutions.
-- [Credits](/misc/credits/): Credits and acknowledgements
-- [Frequently Asked Questions](/misc/FAQ/): Frequently asked questions about LiveStore
-- [Note on Package Management](/misc/package-management/)
-- [Sponsoring LiveStore](/misc/sponsoring/)
-- [Design Partners](/misc/design-partners/)
-- [Resources](/misc/resources/): Resources, assets, logos, etc about LiveStore
-- [Overview and prerequisites](/tutorial/0-welcome/)
-- [1. Set up starter project with React, Vite & Tailwind](/tutorial/1-setup-starter-project/)
-- [4. Sync data to Cloudflare](/tutorial/4-sync-data-via-cloudflare/)
-- [6. Persist UI state](/tutorial/6-persist-ui-state/)
-- [5. Expand business logic with more events](/tutorial/5-expand-business-logic/)
-- [2. Deploy to Cloudflare Workers](/tutorial/2-deploy-to-cloudflare/)
-- [Next steps](/tutorial/7-next-steps/)
-- [3. Read and write todos via LiveStore](/tutorial/3-read-and-write-todos-via-livestore/)
-- [Offline Support](/patterns/offline/)
-- [Side effect](/patterns/side-effects/): How to run side-effects for LiveStore events
-- [List Ordering](/patterns/list-ordering/): Implement drag-and-drop list ordering with fractional indexing
-- [Effect](/patterns/effect/)
-- [Version control](/patterns/version-control/)
-- [Anonymous user transition](/patterns/anonymous-user-transition/): How to transition an anonymous user to a logged in user
-- [File Management](/patterns/file-management/): How to manage files with LiveStore
-- [Rich Text Editing](/patterns/rich-text-editing/)
-- [Auth](/patterns/auth/)
-- [Encryption](/patterns/encryption/)
-- [State Machines](/patterns/state-machines/): How to use state machines with LiveStore
-- [App Evolution](/patterns/app-evolution/): How to evolve your app and roll out new app versions
-- [Storybook Testing (React)](/patterns/storybook/): How to set up LiveStore with Storybook for component development and testing in React.
-- [External Data](/patterns/external-data/)
-- [Undo/Redo](/patterns/undo-redo/): How to implement undo/redo functionality with LiveStore
-- [File Structure](/patterns/file-structure/)
-- [Presence](/patterns/presence/): How to implement presence functionality with LiveStore
-- [ORM](/patterns/orm/): How to use an ORM with LiveStore
-- [AI](/patterns/ai/): How to use LiveStore to build AI applications
-- [Monorepo](/contributing/monorepo/): Notes on the monorepo setup of LiveStore.
-- [Contributing](/contributing/contributing/): Notes for developers interested in contributing to LiveStore.
-- [Docs](/contributing/docs/): Notes on contributing to the LiveStore docs
-- [Docs](//)
-- [Getting started with LiveStore + Vue](/getting-started/vue/): How to use LiveStore with Vue.
-- [Expo](/getting-started/expo/): Learn how to use LiveStore with Expo.
-- [Solid](/getting-started/solid/): Learn how to use LiveStore with Solid.
-- [Node](/getting-started/node/): Learn how to use LiveStore with Node.
-- [Getting started with LiveStore + React](/getting-started/react-web/): How to use LiveStore with React on the web.
-- [Expo Adapter Examples](/examples/expo-adapter/): LiveStore examples built with the Expo adapter for React Native mobile applications
-- [Web Adapter Examples](/examples/web-adapter/): LiveStore examples built with the Web adapter for browser environments
-- [Examples](/examples/): Explore LiveStore example applications across different platforms and use cases
-- [Node Adapter Examples](/examples/node-adapter/): LiveStore examples built with the Node adapter for server-side environments
-- [Cloudflare Durable Objects Examples](/examples/cloudflare-adapter/): LiveStore examples built with the Cloudflare adapter for edge computing and Durable Objects
-- [API Reference](/api/)
-- [Technology comparison](/evaluation/technology-comparison/): How LiveStore compares to other related technologies
-- [Event Sourcing](/evaluation/event-sourcing/): Why and how LiveStore uses event sourcing for data flow, syncing and migrations.
-- [How LiveStore works](/evaluation/how-livestore-works/)
-- [Performance](/evaluation/performance/)
-- [When to use LiveStore (and when not)](/evaluation/when-livestore/): Considerations when deciding to use LiveStore.
-- [Design Decisions](/evaluation/design-decisions/): Design decisions and trade-offs made in the development of LiveStore
-- [State of the project](/evaluation/state-of-the-project/): A high-level overview of the current state of the project.
-- [Complex UI state](/data-modeling/complex-ui-state/): How to model complex UI state in LiveStore.
-- [Data Modeling](/data-modeling/): How to model data in LiveStore.
-- [Todo app with shared workspaces](/data-modeling/todo-workspaces/): How to model a todo workspace app with shared workspaces in LiveStore.
-- [AI agent](/data-modeling/ai-agent/): How to model an AI agent in LiveStore.
-- [Turn-based game](/data-modeling/turnbased-game/): How to model a turn-based game in LiveStore.
-- [Expo Adapter](/reference/platform-adapters/expo-adapter/)
-- [Web Adapter](/reference/platform-adapters/web-adapter/): Information about LiveStore's web adapter
-- [Cloudflare Durable Object Adapter](/reference/platform-adapters/cloudflare-durable-object-adapter/)
-- [Tauri Adapter](/reference/platform-adapters/tauri-adapter/)
-- [Node Adapter](/reference/platform-adapters/node-adapter/)
-- [Electron Adapter](/reference/platform-adapters/electron-adapter/)
-- [LiveStore CLI](/reference/cli/): Command-line interface for LiveStore project scaffolding and development tools.
-- [Devtools](/reference/devtools/)
-- [Events](/reference/events/)
-- [Concepts](/reference/concepts/): Concepts in LiveStore
-- [Store](/reference/store/)
-- [React integration for LiveStore](/reference/framework-integrations/react-integration/): How to integrate LiveStore with React.
-- [Custom Elements](/reference/framework-integrations/custom-elements/): How to integrate LiveStore with Custom Elements aka Web Components.
-- [Svelte integration](/reference/framework-integrations/svelte-integration/): How to integrate LiveStore with Svelte.
-- [Vue integration for LiveStore](/reference/framework-integrations/vue-integration/): How to integrate LiveStore with Vue.
-- [Solid integration](/reference/framework-integrations/solid-integration/): How to integrate LiveStore with Solid.
-- [SQL Queries](/reference/state/sql-queries/)
-- [Materializers](/reference/state/materializers/)
-- [SQLite State Schema](/reference/state/sqlite-schema/)
-- [SQLite in LiveStore](/reference/state/sqlite/): Notes on how to use SQLite in LiveStore
-- [SQLite State Schema (Effect Schema)](/reference/state/sqlite-schema-effect/)
-- [Reactivity System](/reference/reactivity-system/)
-- [Debugging a LiveStore app](/reference/debugging/)
-- [OpenTelemetry](/reference/opentelemetry/)
-- [MCP Integration](/reference/mcp/): Model Context Protocol integration for AI assistants like Claude.
-- [Syncing](/reference/syncing/)
-- [Server-side clients](/reference/syncing/server-side-clients/)
-- [S2](/reference/syncing/sync-provider/s2/): Use the official S2 backend with LiveStore via @livestore/sync-s2
-- [Cloudflare Workers](/reference/syncing/sync-provider/cloudflare/)
-- [Build your own sync provider](/reference/syncing/sync-provider/custom/)
-- [ElectricSQL](/reference/syncing/sync-provider/electricsql/)
-
-
-### NPM packages
+
+## Getting started
+
+- [Getting started with LiveStore + React](/getting-started/react-web): How to use LiveStore with React on the web.
+- [Expo](/getting-started/expo): Learn how to use LiveStore with Expo.
+- [Node](/getting-started/node): Learn how to use LiveStore with Node.
+- [Getting started with LiveStore + Vue](/getting-started/vue): How to use LiveStore with Vue.
+- [Solid](/getting-started/solid): Learn how to use LiveStore with Solid.
+
+## Tutorial
+
+- [Overview and prerequisites](/tutorial/0-welcome)
+- [1. Set up starter project with React, Vite & Tailwind](/tutorial/1-setup-starter-project)
+- [2. Deploy to Cloudflare Workers](/tutorial/2-deploy-to-cloudflare)
+- [3. Read and write todos via LiveStore](/tutorial/3-read-and-write-todos-via-livestore)
+- [4. Sync data to Cloudflare](/tutorial/4-sync-data-via-cloudflare)
+- [5. Expand business logic with more events](/tutorial/5-expand-business-logic)
+- [6. Persist UI state](/tutorial/6-persist-ui-state)
+- [Next steps](/tutorial/7-next-steps)
+
+## Overview
+
+- [Introduction](/overview/introduction)
+- [Why LiveStore?](/overview/why-livestore)
+- [How LiveStore works](/overview/how-livestore-works)
+- [Concepts](/overview/concepts): Concepts in LiveStore
+- [When to use LiveStore (and when not)](/overview/when-livestore): Considerations when deciding to use LiveStore.
+- [Technology comparison](/overview/technology-comparison): How LiveStore compares to other related technologies
+
+## Building with LiveStore
+
+- [Rules for AI agents](/building-with-livestore/rules-for-ai-agents)
+- [Events](/building-with-livestore/events)
+- [Data modeling](/building-with-livestore/data-modeling)
+- [CRUD](/building-with-livestore/crud): CRUD
+- [Store](/building-with-livestore/store)
+- [Complex UI state](/building-with-livestore/complex-ui-state): How to model complex UI state in LiveStore.
+- [Reactivity system](/building-with-livestore/reactivity-system)
+- [Syncing](/building-with-livestore/syncing): Syncing
+- [Debugging a LiveStore app](/building-with-livestore/debugging)
+- [Devtools](/building-with-livestore/devtools)
+- [OpenTelemetry](/building-with-livestore/opentelemetry)
+- [Production checklist](/building-with-livestore/production-checklist): Checklist for productionizing a LiveStore app
+
+### State
+
+- [SQLite state schema](/building-with-livestore/state/sqlite-schema)
+- [SQLite state schema (Effect schema)](/building-with-livestore/state/sqlite-schema-effect)
+- [SQL queries](/building-with-livestore/state/sql-queries)
+- [Materializers](/building-with-livestore/state/materializers)
+- [SQLite in LiveStore](/building-with-livestore/state/sqlite): Notes on how to use SQLite in LiveStore
+
+### Tools
+
+- [LiveStore CLI](/building-with-livestore/tools/cli): Command-line interface for LiveStore project scaffolding and development tools.
+- [MCP integration](/building-with-livestore/tools/mcp): Model Context Protocol integration for AI assistants like Claude.
+
+### Examples
+
+- [Todo app with shared workspaces](/building-with-livestore/examples/todo-workspaces): How to model a todo workspace app with shared workspaces in LiveStore.
+- [Turn-based game](/building-with-livestore/examples/turnbased-game): How to model a turn-based game in LiveStore.
+- [AI agent](/building-with-livestore/examples/ai-agent): How to model an AI agent in LiveStore.
+
+## Framework integrations
+
+- [React integration for LiveStore](/framework-integrations/react-integration): How to integrate LiveStore with React.
+- [Custom elements](/framework-integrations/custom-elements): How to integrate LiveStore with Custom Elements aka Web Components.
+- [Svelte integration](/framework-integrations/svelte-integration): How to integrate LiveStore with Svelte.
+- [Vue integration for LiveStore](/framework-integrations/vue-integration): How to integrate LiveStore with Vue.
+- [Solid integration](/framework-integrations/solid-integration): How to integrate LiveStore with Solid.
+
+## Platform adapters
+
+- [Web adapter](/platform-adapters/web-adapter): Information about LiveStore's web adapter
+- [Expo Adapter](/platform-adapters/expo-adapter): LiveStore adapter for React Native apps built with Expo
+- [Node adapter](/platform-adapters/node-adapter)
+- [Cloudflare Durable Object adapter](/platform-adapters/cloudflare-durable-object-adapter)
+- [Tauri adapter](/platform-adapters/tauri-adapter)
+- [Electron adapter](/platform-adapters/electron-adapter)
+
+## Sync providers
+
+- [Cloudflare Workers](/sync-providers/cloudflare)
+- [ElectricSQL](/sync-providers/electricsql)
+- [S2](/sync-providers/s2): Use the official S2 backend with LiveStore via @livestore/sync-s2
+- [Build your own sync provider](/sync-providers/custom)
+
+## Patterns
+
+- [Server-side clients](/patterns/server-side-clients)
+- [Encryption](/patterns/encryption)
+- [Effect](/patterns/effect)
+- [Rich Text Editing](/patterns/rich-text-editing)
+- [Auth](/patterns/auth)
+- [Rich text editing](/patterns/rich-text-editing)
+- [List Ordering](/patterns/list-ordering): Implement drag-and-drop list ordering with fractional indexing
+- [External data](/patterns/external-data)
+- [Offline support](/patterns/offline)
+- [Side effect](/patterns/side-effects): How to run side-effects for LiveStore events
+- [Version control](/patterns/version-control)
+- [Anonymous user transition](/patterns/anonymous-user-transition): How to transition an anonymous user to a logged in user
+- [File management](/patterns/file-management): How to manage files with LiveStore
+- [State machines](/patterns/state-machines): How to use state machines with LiveStore
+- [App evolution](/patterns/app-evolution): How to evolve your app and roll out new app versions
+- [Storybook testing (React)](/patterns/storybook): How to set up LiveStore with Storybook for component development and testing in React.
+- [Undo/Redo](/patterns/undo-redo): How to implement undo/redo functionality with LiveStore
+- [File structure](/patterns/file-structure)
+- [Presence](/patterns/presence): How to implement presence functionality with LiveStore
+- [ORM](/patterns/orm): How to use an ORM with LiveStore
+- [AI](/patterns/ai): How to use LiveStore to build AI applications
+
+## Understanding LiveStore
+
+- [Event sourcing](/understanding-livestore/event-sourcing): Why and how LiveStore uses event sourcing for data flow, syncing and migrations.
+- [Design decisions](/understanding-livestore/design-decisions): Design decisions and trade-offs made in the development of LiveStore
+
+## Sustainable open source
+
+- [Sponsoring LiveStore](/sustainable-open-source/sponsoring)
+
+### Contributing
+
+- [Info](/sustainable-open-source/contributing/info): Notes for developers interested in contributing to LiveStore.
+- [Monorepo](/sustainable-open-source/contributing/monorepo): Notes on the monorepo setup of LiveStore.
+- [Docs](/sustainable-open-source/contributing/docs): Notes on contributing to the LiveStore docs
+
+## Miscellaneous
+
+- [Frequently asked questions](/misc/FAQ): Frequently asked questions about LiveStore
+- [State of the project](/misc/state-of-the-project): A high-level overview of the current state of the project.
+- [Performance](/misc/performance)
+- [Community](/misc/community)
+- [Troubleshooting](/misc/troubleshooting): Common issues in apps using LiveStore and possible solutions.
+- [Credits](/misc/credits): Credits and acknowledgements
+- [Resources](/misc/resources): Resources, assets, logos, etc about LiveStore
+- [Design partners](/misc/design-partners)
+- [Code of conduct](/misc/CODE_OF_CONDUCT): Our code of conduct for the LiveStore community.
+- [Note on package management](/misc/package-management)
+
+
+### npm packages
 
 - Main package: <NpmLink packageName="livestore" />
 - Framework integrations:

package/docs/llms.txt

@@ -6,99 +6,141 @@
 
 - Most LiveStore APIs are synchronous and don't need `await`
 
-## Docs
-
-- [Code of Conduct](/misc/CODE_OF_CONDUCT/): Our code of conduct for the LiveStore community.
-- [Community](/misc/community/)
-- [Troubleshooting](/misc/troubleshooting/): Common issues in apps using LiveStore and possible solutions.
-- [Credits](/misc/credits/): Credits and acknowledgements
-- [Frequently Asked Questions](/misc/FAQ/): Frequently asked questions about LiveStore
-- [Note on Package Management](/misc/package-management/)
-- [Sponsoring LiveStore](/misc/sponsoring/)
-- [Design Partners](/misc/design-partners/)
-- [Resources](/misc/resources/): Resources, assets, logos, etc about LiveStore
-- [Overview and prerequisites](/tutorial/0-welcome/)
-- [1. Set up starter project with React, Vite & Tailwind](/tutorial/1-setup-starter-project/)
-- [4. Sync data to Cloudflare](/tutorial/4-sync-data-via-cloudflare/)
-- [6. Persist UI state](/tutorial/6-persist-ui-state/)
-- [5. Expand business logic with more events](/tutorial/5-expand-business-logic/)
-- [2. Deploy to Cloudflare Workers](/tutorial/2-deploy-to-cloudflare/)
-- [Next steps](/tutorial/7-next-steps/)
-- [3. Read and write todos via LiveStore](/tutorial/3-read-and-write-todos-via-livestore/)
-- [Offline Support](/patterns/offline/)
-- [Side effect](/patterns/side-effects/): How to run side-effects for LiveStore events
-- [List Ordering](/patterns/list-ordering/): Implement drag-and-drop list ordering with fractional indexing
-- [Effect](/patterns/effect/)
-- [Version control](/patterns/version-control/)
-- [Anonymous user transition](/patterns/anonymous-user-transition/): How to transition an anonymous user to a logged in user
-- [File Management](/patterns/file-management/): How to manage files with LiveStore
-- [Rich Text Editing](/patterns/rich-text-editing/)
-- [Auth](/patterns/auth/)
-- [Encryption](/patterns/encryption/)
-- [State Machines](/patterns/state-machines/): How to use state machines with LiveStore
-- [App Evolution](/patterns/app-evolution/): How to evolve your app and roll out new app versions
-- [Storybook Testing (React)](/patterns/storybook/): How to set up LiveStore with Storybook for component development and testing in React.
-- [External Data](/patterns/external-data/)
-- [Undo/Redo](/patterns/undo-redo/): How to implement undo/redo functionality with LiveStore
-- [File Structure](/patterns/file-structure/)
-- [Presence](/patterns/presence/): How to implement presence functionality with LiveStore
-- [ORM](/patterns/orm/): How to use an ORM with LiveStore
-- [AI](/patterns/ai/): How to use LiveStore to build AI applications
-- [Monorepo](/contributing/monorepo/): Notes on the monorepo setup of LiveStore.
-- [Contributing](/contributing/contributing/): Notes for developers interested in contributing to LiveStore.
-- [Docs](/contributing/docs/): Notes on contributing to the LiveStore docs
-- [Docs](//)
-- [Getting started with LiveStore + Vue](/getting-started/vue/): How to use LiveStore with Vue.
-- [Expo](/getting-started/expo/): Learn how to use LiveStore with Expo.
-- [Solid](/getting-started/solid/): Learn how to use LiveStore with Solid.
-- [Node](/getting-started/node/): Learn how to use LiveStore with Node.
-- [Getting started with LiveStore + React](/getting-started/react-web/): How to use LiveStore with React on the web.
-- [Expo Adapter Examples](/examples/expo-adapter/): LiveStore examples built with the Expo adapter for React Native mobile applications
-- [Web Adapter Examples](/examples/web-adapter/): LiveStore examples built with the Web adapter for browser environments
-- [Examples](/examples/): Explore LiveStore example applications across different platforms and use cases
-- [Node Adapter Examples](/examples/node-adapter/): LiveStore examples built with the Node adapter for server-side environments
-- [Cloudflare Durable Objects Examples](/examples/cloudflare-adapter/): LiveStore examples built with the Cloudflare adapter for edge computing and Durable Objects
-- [API Reference](/api/)
-- [Technology comparison](/evaluation/technology-comparison/): How LiveStore compares to other related technologies
-- [Event Sourcing](/evaluation/event-sourcing/): Why and how LiveStore uses event sourcing for data flow, syncing and migrations.
-- [How LiveStore works](/evaluation/how-livestore-works/)
-- [Performance](/evaluation/performance/)
-- [When to use LiveStore (and when not)](/evaluation/when-livestore/): Considerations when deciding to use LiveStore.
-- [Design Decisions](/evaluation/design-decisions/): Design decisions and trade-offs made in the development of LiveStore
-- [State of the project](/evaluation/state-of-the-project/): A high-level overview of the current state of the project.
-- [Complex UI state](/data-modeling/complex-ui-state/): How to model complex UI state in LiveStore.
-- [Data Modeling](/data-modeling/): How to model data in LiveStore.
-- [Todo app with shared workspaces](/data-modeling/todo-workspaces/): How to model a todo workspace app with shared workspaces in LiveStore.
-- [AI agent](/data-modeling/ai-agent/): How to model an AI agent in LiveStore.
-- [Turn-based game](/data-modeling/turnbased-game/): How to model a turn-based game in LiveStore.
-- [Expo Adapter](/reference/platform-adapters/expo-adapter/)
-- [Web Adapter](/reference/platform-adapters/web-adapter/): Information about LiveStore's web adapter
-- [Cloudflare Durable Object Adapter](/reference/platform-adapters/cloudflare-durable-object-adapter/)
-- [Tauri Adapter](/reference/platform-adapters/tauri-adapter/)
-- [Node Adapter](/reference/platform-adapters/node-adapter/)
-- [Electron Adapter](/reference/platform-adapters/electron-adapter/)
-- [LiveStore CLI](/reference/cli/): Command-line interface for LiveStore project scaffolding and development tools.
-- [Devtools](/reference/devtools/)
-- [Events](/reference/events/)
-- [Concepts](/reference/concepts/): Concepts in LiveStore
-- [Store](/reference/store/)
-- [React integration for LiveStore](/reference/framework-integrations/react-integration/): How to integrate LiveStore with React.
-- [Custom Elements](/reference/framework-integrations/custom-elements/): How to integrate LiveStore with Custom Elements aka Web Components.
-- [Svelte integration](/reference/framework-integrations/svelte-integration/): How to integrate LiveStore with Svelte.
-- [Vue integration for LiveStore](/reference/framework-integrations/vue-integration/): How to integrate LiveStore with Vue.
-- [Solid integration](/reference/framework-integrations/solid-integration/): How to integrate LiveStore with Solid.
-- [SQL Queries](/reference/state/sql-queries/)
-- [Materializers](/reference/state/materializers/)
-- [SQLite State Schema](/reference/state/sqlite-schema/)
-- [SQLite in LiveStore](/reference/state/sqlite/): Notes on how to use SQLite in LiveStore
-- [SQLite State Schema (Effect Schema)](/reference/state/sqlite-schema-effect/)
-- [Reactivity System](/reference/reactivity-system/)
-- [Debugging a LiveStore app](/reference/debugging/)
-- [OpenTelemetry](/reference/opentelemetry/)
-- [MCP Integration](/reference/mcp/): Model Context Protocol integration for AI assistants like Claude.
-- [Syncing](/reference/syncing/)
-- [Server-side clients](/reference/syncing/server-side-clients/)
-- [S2](/reference/syncing/sync-provider/s2/): Use the official S2 backend with LiveStore via @livestore/sync-s2
-- [Cloudflare Workers](/reference/syncing/sync-provider/cloudflare/)
-- [Build your own sync provider](/reference/syncing/sync-provider/custom/)
-- [ElectricSQL](/reference/syncing/sync-provider/electricsql/)
+
+## Getting started
+
+- [Getting started with LiveStore + React](/getting-started/react-web): How to use LiveStore with React on the web.
+- [Expo](/getting-started/expo): Learn how to use LiveStore with Expo.
+- [Node](/getting-started/node): Learn how to use LiveStore with Node.
+- [Getting started with LiveStore + Vue](/getting-started/vue): How to use LiveStore with Vue.
+- [Solid](/getting-started/solid): Learn how to use LiveStore with Solid.
+
+## Tutorial
+
+- [Overview and prerequisites](/tutorial/0-welcome)
+- [1. Set up starter project with React, Vite & Tailwind](/tutorial/1-setup-starter-project)
+- [2. Deploy to Cloudflare Workers](/tutorial/2-deploy-to-cloudflare)
+- [3. Read and write todos via LiveStore](/tutorial/3-read-and-write-todos-via-livestore)
+- [4. Sync data to Cloudflare](/tutorial/4-sync-data-via-cloudflare)
+- [5. Expand business logic with more events](/tutorial/5-expand-business-logic)
+- [6. Persist UI state](/tutorial/6-persist-ui-state)
+- [Next steps](/tutorial/7-next-steps)
+
+## Overview
+
+- [Introduction](/overview/introduction)
+- [Why LiveStore?](/overview/why-livestore)
+- [How LiveStore works](/overview/how-livestore-works)
+- [Concepts](/overview/concepts): Concepts in LiveStore
+- [When to use LiveStore (and when not)](/overview/when-livestore): Considerations when deciding to use LiveStore.
+- [Technology comparison](/overview/technology-comparison): How LiveStore compares to other related technologies
+
+## Building with LiveStore
+
+- [Rules for AI agents](/building-with-livestore/rules-for-ai-agents)
+- [Events](/building-with-livestore/events)
+- [Data modeling](/building-with-livestore/data-modeling)
+- [CRUD](/building-with-livestore/crud): CRUD
+- [Store](/building-with-livestore/store)
+- [Complex UI state](/building-with-livestore/complex-ui-state): How to model complex UI state in LiveStore.
+- [Reactivity system](/building-with-livestore/reactivity-system)
+- [Syncing](/building-with-livestore/syncing): Syncing
+- [Debugging a LiveStore app](/building-with-livestore/debugging)
+- [Devtools](/building-with-livestore/devtools)
+- [OpenTelemetry](/building-with-livestore/opentelemetry)
+- [Production checklist](/building-with-livestore/production-checklist): Checklist for productionizing a LiveStore app
+
+### State
+
+- [SQLite state schema](/building-with-livestore/state/sqlite-schema)
+- [SQLite state schema (Effect schema)](/building-with-livestore/state/sqlite-schema-effect)
+- [SQL queries](/building-with-livestore/state/sql-queries)
+- [Materializers](/building-with-livestore/state/materializers)
+- [SQLite in LiveStore](/building-with-livestore/state/sqlite): Notes on how to use SQLite in LiveStore
+
+### Tools
+
+- [LiveStore CLI](/building-with-livestore/tools/cli): Command-line interface for LiveStore project scaffolding and development tools.
+- [MCP integration](/building-with-livestore/tools/mcp): Model Context Protocol integration for AI assistants like Claude.
+
+### Examples
+
+- [Todo app with shared workspaces](/building-with-livestore/examples/todo-workspaces): How to model a todo workspace app with shared workspaces in LiveStore.
+- [Turn-based game](/building-with-livestore/examples/turnbased-game): How to model a turn-based game in LiveStore.
+- [AI agent](/building-with-livestore/examples/ai-agent): How to model an AI agent in LiveStore.
+
+## Framework integrations
+
+- [React integration for LiveStore](/framework-integrations/react-integration): How to integrate LiveStore with React.
+- [Custom elements](/framework-integrations/custom-elements): How to integrate LiveStore with Custom Elements aka Web Components.
+- [Svelte integration](/framework-integrations/svelte-integration): How to integrate LiveStore with Svelte.
+- [Vue integration for LiveStore](/framework-integrations/vue-integration): How to integrate LiveStore with Vue.
+- [Solid integration](/framework-integrations/solid-integration): How to integrate LiveStore with Solid.
+
+## Platform adapters
+
+- [Web adapter](/platform-adapters/web-adapter): Information about LiveStore's web adapter
+- [Expo Adapter](/platform-adapters/expo-adapter): LiveStore adapter for React Native apps built with Expo
+- [Node adapter](/platform-adapters/node-adapter)
+- [Cloudflare Durable Object adapter](/platform-adapters/cloudflare-durable-object-adapter)
+- [Tauri adapter](/platform-adapters/tauri-adapter)
+- [Electron adapter](/platform-adapters/electron-adapter)
+
+## Sync providers
+
+- [Cloudflare Workers](/sync-providers/cloudflare)
+- [ElectricSQL](/sync-providers/electricsql)
+- [S2](/sync-providers/s2): Use the official S2 backend with LiveStore via @livestore/sync-s2
+- [Build your own sync provider](/sync-providers/custom)
+
+## Patterns
+
+- [Server-side clients](/patterns/server-side-clients)
+- [Encryption](/patterns/encryption)
+- [Effect](/patterns/effect)
+- [Rich Text Editing](/patterns/rich-text-editing)
+- [Auth](/patterns/auth)
+- [Rich text editing](/patterns/rich-text-editing)
+- [List Ordering](/patterns/list-ordering): Implement drag-and-drop list ordering with fractional indexing
+- [External data](/patterns/external-data)
+- [Offline support](/patterns/offline)
+- [Side effect](/patterns/side-effects): How to run side-effects for LiveStore events
+- [Version control](/patterns/version-control)
+- [Anonymous user transition](/patterns/anonymous-user-transition): How to transition an anonymous user to a logged in user
+- [File management](/patterns/file-management): How to manage files with LiveStore
+- [State machines](/patterns/state-machines): How to use state machines with LiveStore
+- [App evolution](/patterns/app-evolution): How to evolve your app and roll out new app versions
+- [Storybook testing (React)](/patterns/storybook): How to set up LiveStore with Storybook for component development and testing in React.
+- [Undo/Redo](/patterns/undo-redo): How to implement undo/redo functionality with LiveStore
+- [File structure](/patterns/file-structure)
+- [Presence](/patterns/presence): How to implement presence functionality with LiveStore
+- [ORM](/patterns/orm): How to use an ORM with LiveStore
+- [AI](/patterns/ai): How to use LiveStore to build AI applications
+
+## Understanding LiveStore
+
+- [Event sourcing](/understanding-livestore/event-sourcing): Why and how LiveStore uses event sourcing for data flow, syncing and migrations.
+- [Design decisions](/understanding-livestore/design-decisions): Design decisions and trade-offs made in the development of LiveStore
+
+## Sustainable open source
+
+- [Sponsoring LiveStore](/sustainable-open-source/sponsoring)
+
+### Contributing
+
+- [Info](/sustainable-open-source/contributing/info): Notes for developers interested in contributing to LiveStore.
+- [Monorepo](/sustainable-open-source/contributing/monorepo): Notes on the monorepo setup of LiveStore.
+- [Docs](/sustainable-open-source/contributing/docs): Notes on contributing to the LiveStore docs
+
+## Miscellaneous
+
+- [Frequently asked questions](/misc/FAQ): Frequently asked questions about LiveStore
+- [State of the project](/misc/state-of-the-project): A high-level overview of the current state of the project.
+- [Performance](/misc/performance)
+- [Community](/misc/community)
+- [Troubleshooting](/misc/troubleshooting): Common issues in apps using LiveStore and possible solutions.
+- [Credits](/misc/credits): Credits and acknowledgements
+- [Resources](/misc/resources): Resources, assets, logos, etc about LiveStore
+- [Design partners](/misc/design-partners)
+- [Code of conduct](/misc/CODE_OF_CONDUCT): Our code of conduct for the LiveStore community.
+- [Note on package management](/misc/package-management)

package/docs/misc/CODE_OF_CONDUCT/index.md

@@ -1,4 +1,4 @@
-# Code of Conduct
+# Code of conduct
 
 ## Our Pledge
 

package/docs/misc/FAQ/index.md

@@ -1,4 +1,4 @@
-# Frequently Asked Questions
+# Frequently asked questions
 
 ### Does LiveStore have optimistic updates?
 

package/docs/misc/community/index.md

@@ -25,6 +25,7 @@ You can join future office hour events [here](https://lu.ma/livestore).
 
 ## Conference talks & podcasts
 
+- [Native-Grade Web Apps with Local-First Data (ViteConf 2025)](https://www.youtube.com/watch?v=h5Bs0vEka5U)
 - [Sync different: Event sourcing in local-first apps](https://www.youtube.com/watch?v=nyPl84BopKc)
 - [From Prisma Founder to LiveStore: Building local-first apps with Johannes Schickling (Aaron Francis interview)](https://www.youtube.com/watch?v=aKTbGIrkrLE)
 
@@ -81,7 +82,7 @@ Here are some app ideas:
 - Diff queries in SQLite
 - IVM
 
-## Notable LiveStore projects (Open-source)
+## Notable LiveStore projects (open-source)
 
 - [WorkSquared](https://github.com/sociotechnica-org/work-squared): An AI-haunted workplace to coordinate, plan, and execute.
 - [Cheffect](https://github.com/tim-smart/cheffect): Local-first recipe management app built with LiveStore and Effect

package/docs/misc/design-partners/index.md

@@ -1,4 +1,4 @@
-# Design Partners
+# Design partners
 
 LiveStore is looking for design partners with the following aims:
 - For your company:

package/docs/misc/package-management/index.md

@@ -1,4 +1,4 @@
-# Note on Package Management
+# Note on package management
 
 export const catalog = `\
 catalog:

package/docs/misc/resources/index.md

@@ -31,7 +31,7 @@ Feel free to use the following assets for presentations, blog posts, etc about L
   </tbody>
 </table>
 
-## Architecture Diagrams
+## Architecture diagrams
 
 ### Client scenarios