docs: Add db-core/persistence skill and update library version to 0.6.0 by KyleAMathews · Pull Request #1421 · TanStack/db

KyleAMathews · 2026-03-27T19:52:20Z

Updates all SKILL.md documentation files to match v0.6.0 APIs, adds a new persistence skill, and registers all skill-bearing packages with the tanstack-intent keyword for discoverability.

Approach

New documentation

db-core/persistence/SKILL.md: Complete guide to SQLite-backed persistence covering all 8 platform adapters, local-only and synced modes, multi-tab/process coordination, schema versioning, and common mistakes.

Expanded existing skills

live-queries: Virtual properties ($synced, $origin, $key, $collectionId), includes/subqueries, queryOnce, createEffect
collection-setup: Indexing (autoIndex, defaultIndexType), PowerSync on-demand sync with onLoad/onLoadSubset, progressive syncMode (Electric-only), function-based queryKey pitfall
custom-adapter: metadata API for per-row and per-collection sync state (always provided, durable only with persistence), resume token pattern
react-db, solid-db: Virtual properties, findOne() return types

Package metadata

library_version bumped from 0.5.30 to 0.6.0 across all 13 skill files
tanstack-intent keyword added to all 7 packages with skills

Key invariants

All code examples verified against current source (virtual props, queryOnce, createEffect, metadata API, persistence options, Electron IPC, indexing)
Version numbers consistent across all skill files
Cross-references between skills are accurate

Non-goals

No source code changes — documentation and package.json metadata only
Did not address pre-existing @tanstack/intent devDependency or !skills/_artifacts file exclusion warnings

Verification

npx @tanstack/intent@latest validate packages/db/skills
npx @tanstack/intent@latest validate packages/react-db/skills
# All 13 skill files pass validation

Files changed

File	Change
`db/skills/db-core/persistence/SKILL.md`	New — full persistence guide
`db/skills/db-core/live-queries/SKILL.md`	Add virtual props, includes, queryOnce, createEffect
`db/skills/db-core/collection-setup/SKILL.md`	Add indexing, PowerSync on-demand, progressive mode, queryKey mistake
`db/skills/db-core/custom-adapter/SKILL.md`	Add metadata API docs
`db/skills/db-core/SKILL.md`	Version bump
`db/skills/db-core/mutations-optimistic/SKILL.md`	Version bump
`db/skills/meta-framework/SKILL.md`	Version bump
`react-db/skills/react-db/SKILL.md`	Virtual props, version bump
`solid-db/skills/solid-db/SKILL.md`	Virtual props, findOne
`angular-db/skills/angular-db/SKILL.md`	Version bump
`svelte-db/skills/svelte-db/SKILL.md`	Version bump
`vue-db/skills/vue-db/SKILL.md`	Version bump
`offline-transactions/skills/offline/SKILL.md`	Version bump
7× `package.json`	Add `tanstack-intent` keyword

Add virtual properties section ($synced, $origin, $key, $collectionId) from upstream live-queries guide and bump library_version to 0.6.0. https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

- Bump library_version to 0.6.0 across all skills - live-queries: add virtual properties, includes subqueries, toArray/concat - collection-setup: add on-demand sync mode, opt-in indexing, queryKey prefix convention, Electric timeout fix - custom-adapter: add persisted sync metadata API (row + collection) - solid-db: add findOne single-result support - react-db was updated in prior commit https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

Both features are documented in the source doc (docs/guides/live-queries.md) but were missing from the SKILL. Found by cross-referencing with the 0.6 release blog post. https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

New sub-skill covering persistedCollectionOptions, all 8 platform adapters (browser, React Native, Expo, Electron, Node, Capacitor, Tauri, Cloudflare DO), multi-tab coordination, schema versioning, and local-only vs synced modes. Also updates the db-core index to reference the new skill. https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

pkg-pr-new · 2026-03-27T19:56:40Z

More templates

@tanstack/angular-db

npm i https://pkg.pr.new/@tanstack/angular-db@1421

@tanstack/browser-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/browser-db-sqlite-persistence@1421

@tanstack/capacitor-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/capacitor-db-sqlite-persistence@1421

@tanstack/cloudflare-durable-objects-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/cloudflare-durable-objects-db-sqlite-persistence@1421

@tanstack/db

npm i https://pkg.pr.new/@tanstack/db@1421

@tanstack/db-ivm

npm i https://pkg.pr.new/@tanstack/db-ivm@1421

@tanstack/db-sqlite-persistence-core

npm i https://pkg.pr.new/@tanstack/db-sqlite-persistence-core@1421

@tanstack/electric-db-collection

npm i https://pkg.pr.new/@tanstack/electric-db-collection@1421

@tanstack/electron-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/electron-db-sqlite-persistence@1421

@tanstack/expo-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/expo-db-sqlite-persistence@1421

@tanstack/node-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/node-db-sqlite-persistence@1421

@tanstack/offline-transactions

npm i https://pkg.pr.new/@tanstack/offline-transactions@1421

@tanstack/powersync-db-collection

npm i https://pkg.pr.new/@tanstack/powersync-db-collection@1421

@tanstack/query-db-collection

npm i https://pkg.pr.new/@tanstack/query-db-collection@1421

@tanstack/react-db

npm i https://pkg.pr.new/@tanstack/react-db@1421

@tanstack/react-native-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/react-native-db-sqlite-persistence@1421

@tanstack/rxdb-db-collection

npm i https://pkg.pr.new/@tanstack/rxdb-db-collection@1421

@tanstack/solid-db

npm i https://pkg.pr.new/@tanstack/solid-db@1421

@tanstack/svelte-db

npm i https://pkg.pr.new/@tanstack/svelte-db@1421

@tanstack/tauri-db-sqlite-persistence

npm i https://pkg.pr.new/@tanstack/tauri-db-sqlite-persistence@1421

@tanstack/trailbase-db-collection

npm i https://pkg.pr.new/@tanstack/trailbase-db-collection@1421

@tanstack/vue-db

npm i https://pkg.pr.new/@tanstack/vue-db@1421

commit: b681f9b

github-actions · 2026-03-27T19:57:17Z

Size Change: 0 B

Total Size: 113 kB

ℹ️ View Unchanged

Filename	Size
`./packages/db/dist/esm/collection/change-events.js`	1.39 kB
`./packages/db/dist/esm/collection/changes.js`	1.38 kB
`./packages/db/dist/esm/collection/cleanup-queue.js`	810 B
`./packages/db/dist/esm/collection/events.js`	434 B
`./packages/db/dist/esm/collection/index.js`	3.61 kB
`./packages/db/dist/esm/collection/indexes.js`	1.99 kB
`./packages/db/dist/esm/collection/lifecycle.js`	1.69 kB
`./packages/db/dist/esm/collection/mutations.js`	2.47 kB
`./packages/db/dist/esm/collection/state.js`	5.26 kB
`./packages/db/dist/esm/collection/subscription.js`	3.74 kB
`./packages/db/dist/esm/collection/sync.js`	2.88 kB
`./packages/db/dist/esm/collection/transaction-metadata.js`	144 B
`./packages/db/dist/esm/deferred.js`	207 B
`./packages/db/dist/esm/errors.js`	4.92 kB
`./packages/db/dist/esm/event-emitter.js`	748 B
`./packages/db/dist/esm/index.js`	3 kB
`./packages/db/dist/esm/indexes/auto-index.js`	830 B
`./packages/db/dist/esm/indexes/base-index.js`	729 B
`./packages/db/dist/esm/indexes/basic-index.js`	2.05 kB
`./packages/db/dist/esm/indexes/btree-index.js`	2.17 kB
`./packages/db/dist/esm/indexes/index-registry.js`	820 B
`./packages/db/dist/esm/indexes/reverse-index.js`	538 B
`./packages/db/dist/esm/local-only.js`	890 B
`./packages/db/dist/esm/local-storage.js`	2.1 kB
`./packages/db/dist/esm/optimistic-action.js`	359 B
`./packages/db/dist/esm/paced-mutations.js`	496 B
`./packages/db/dist/esm/proxy.js`	3.75 kB
`./packages/db/dist/esm/query/builder/functions.js`	905 B
`./packages/db/dist/esm/query/builder/index.js`	5.25 kB
`./packages/db/dist/esm/query/builder/ref-proxy.js`	1.05 kB
`./packages/db/dist/esm/query/compiler/evaluators.js`	1.62 kB
`./packages/db/dist/esm/query/compiler/expressions.js`	430 B
`./packages/db/dist/esm/query/compiler/group-by.js`	2.69 kB
`./packages/db/dist/esm/query/compiler/index.js`	3.63 kB
`./packages/db/dist/esm/query/compiler/joins.js`	2.11 kB
`./packages/db/dist/esm/query/compiler/order-by.js`	1.51 kB
`./packages/db/dist/esm/query/compiler/select.js`	1.11 kB
`./packages/db/dist/esm/query/effect.js`	4.78 kB
`./packages/db/dist/esm/query/expression-helpers.js`	1.43 kB
`./packages/db/dist/esm/query/ir.js`	829 B
`./packages/db/dist/esm/query/live-query-collection.js`	360 B
`./packages/db/dist/esm/query/live/collection-config-builder.js`	7.78 kB
`./packages/db/dist/esm/query/live/collection-registry.js`	264 B
`./packages/db/dist/esm/query/live/collection-subscriber.js`	1.94 kB
`./packages/db/dist/esm/query/live/internal.js`	145 B
`./packages/db/dist/esm/query/live/utils.js`	1.64 kB
`./packages/db/dist/esm/query/optimizer.js`	2.62 kB
`./packages/db/dist/esm/query/predicate-utils.js`	2.97 kB
`./packages/db/dist/esm/query/query-once.js`	359 B
`./packages/db/dist/esm/query/subset-dedupe.js`	960 B
`./packages/db/dist/esm/scheduler.js`	1.3 kB
`./packages/db/dist/esm/SortedMap.js`	1.3 kB
`./packages/db/dist/esm/strategies/debounceStrategy.js`	247 B
`./packages/db/dist/esm/strategies/queueStrategy.js`	428 B
`./packages/db/dist/esm/strategies/throttleStrategy.js`	246 B
`./packages/db/dist/esm/transactions.js`	2.9 kB
`./packages/db/dist/esm/utils.js`	927 B
`./packages/db/dist/esm/utils/array-utils.js`	273 B
`./packages/db/dist/esm/utils/browser-polyfills.js`	304 B
`./packages/db/dist/esm/utils/btree.js`	5.61 kB
`./packages/db/dist/esm/utils/comparison.js`	1.05 kB
`./packages/db/dist/esm/utils/cursor.js`	457 B
`./packages/db/dist/esm/utils/index-optimization.js`	1.54 kB
`./packages/db/dist/esm/utils/type-guards.js`	157 B
`./packages/db/dist/esm/virtual-props.js`	360 B

_{compressed-size-action::db-package-size}

github-actions · 2026-03-27T19:57:54Z

Size Change: 0 B

Total Size: 4.23 kB

ℹ️ View Unchanged

Filename	Size
`./packages/react-db/dist/esm/index.js`	249 B
`./packages/react-db/dist/esm/useLiveInfiniteQuery.js`	1.32 kB
`./packages/react-db/dist/esm/useLiveQuery.js`	1.34 kB
`./packages/react-db/dist/esm/useLiveQueryEffect.js`	355 B
`./packages/react-db/dist/esm/useLiveSuspenseQuery.js`	559 B
`./packages/react-db/dist/esm/usePacedMutations.js`	401 B

_{compressed-size-action::react-db-package-size}

- Fix Electron persistence API examples to match actual function signatures - Fix missing id behavior: documents silent UUID generation instead of false error claim - Restore progressive syncMode (Electric-only) that was incorrectly removed - Clarify metadata availability: always provided, durable only with persistence - Add tanstack-intent keyword to all packages with skills - Fix stale version reference and align wording consistency Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Move PowerSync on-demand sync details to powersync-adapter.md reference and function-based queryKey mistake to query-adapter.md reference. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

claude and others added 5 commits March 27, 2026 19:38

docs: update react-db SKILL.md for virtual props and version bump

0b71bd2

Add virtual properties section ($synced, $origin, $key, $collectionId) from upstream live-queries guide and bump library_version to 0.6.0. https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

docs: add queryOnce and createEffect to live-queries SKILL.md

8317dff

Both features are documented in the source doc (docs/guides/live-queries.md) but were missing from the SKILL. Found by cross-referencing with the 0.6 release blog post. https://claude.ai/code/session_01DTyMUCKyRTwuDSwEbhfW46

ci: apply automated fixes

161e3ea

KyleAMathews and others added 4 commits March 27, 2026 14:15

docs: add changeset for skill docs update and tanstack-intent keyword

4287fe4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

ci: apply automated fixes

083c852

docs: move adapter-specific content to reference docs

b681f9b

Move PowerSync on-demand sync details to powersync-adapter.md reference and function-based queryKey mistake to query-adapter.md reference. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

KyleAMathews merged commit 8b7fb1a into main Mar 27, 2026
7 checks passed

KyleAMathews deleted the claude/update-skill-docs-rK4yn branch March 27, 2026 21:26

github-actions bot mentioned this pull request Mar 27, 2026

ci: Version Packages #1422

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: Add db-core/persistence skill and update library version to 0.6.0#1421

docs: Add db-core/persistence skill and update library version to 0.6.0#1421
KyleAMathews merged 9 commits intomainfrom
claude/update-skill-docs-rK4yn

KyleAMathews commented Mar 27, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Mar 27, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 27, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 27, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

KyleAMathews commented Mar 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Approach

Key invariants

Non-goals

Verification

Files changed

Uh oh!

pkg-pr-new bot commented Mar 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

KyleAMathews commented Mar 27, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 27, 2026 •

edited

Loading

github-actions bot commented Mar 27, 2026 •

edited

Loading

github-actions bot commented Mar 27, 2026 •

edited

Loading