TanStack DB — Core Concepts
TanStack DB is a reactive client-side data store. It loads data into typed collections from any backend (REST APIs, sync engines, local storage), provides sub-millisecond live queries via differential dataflow, and supports instant optimistic mutations with automatic rollback.
Framework packages (@tanstack/react-db, @tanstack/vue-db, @tanstack/svelte-db,
@tanstack/solid-db) re-export everything from @tanstack/db plus framework-specific
hooks. In framework projects, import from the framework package directly.
@tanstack/angular-db is the exception -- import operators from @tanstack/db separately.
Sub-Skills
| Need to... | Read |
|---|---|
| Create a collection, pick an adapter, add schema | ../tanstack-db-core-collection-setup/SKILL.md |
| Query data with where, join, groupBy, select | ../tanstack-db-core-live-queries/SKILL.md |
| Insert, update, delete with optimistic UI | ../tanstack-db-core-mutations-optimistic/SKILL.md |
| Build a custom sync adapter | ../tanstack-db-core-custom-adapter/SKILL.md |
| Persist collections to SQLite (offline cache) | ../tanstack-db-core-persistence/SKILL.md |
| Preload collections in route loaders | ../tanstack-db-meta-framework/SKILL.md |
| Add offline transaction queueing | ../tanstack-offline-transactions-offline/SKILL.md (in @tanstack/offline-transactions) |
For framework-specific hooks:
| Framework | Read |
|---|---|
| React | ../tanstack-react-db/SKILL.md |
| Vue | ../tanstack-vue-db/SKILL.md |
| Svelte | ../tanstack-svelte-db/SKILL.md |
| Solid | ../tanstack-solid-db/SKILL.md |
| Angular | ../tanstack-angular-db/SKILL.md |
Quick Decision Tree
- Setting up for the first time? → db-core/collection-setup
- Building queries on collection data? → db-core/live-queries
- Writing data / handling optimistic state? → db-core/mutations-optimistic
- Using React hooks? → react-db
- Preloading in route loaders (Start, Next, Remix)? → meta-framework
- Building an adapter for a new backend? → db-core/custom-adapter
- Persisting collections to SQLite? → db-core/persistence
- Need offline transaction persistence? → offline
Version
Targets @tanstack/db v0.6.17.