Add explanation of client-first vs local-first

[haznai]

🎯 Changes

Clarify the distinction between client-first and local-first frameworks in the "Overview" section. Might make sense to even do an own section of the differentiation, not to confuse people.

discord context:

hazn: am i correct to assume that tanstack-db uses the 'client-first' terminology instead of 'local-first' because the base assumption is that you have just a server backend + optimistic client state (and not a local backend on addition to the server backend)
Kyle Mathews: yes, local-first isn't what we're doing https://www.inkandswitch.com/essay/local-first/
[Local-first software: You own your data, in spite of the cloud](https://www.inkandswitch.com/essay/local-first/)
A new generation of collaborative software that allows users to retain ownership of their data.
hazn: okay, great my assumption is correct! it seems like tanstack-db is halfway there to local-first, any plans/integrations for the future of tanstack-db local-first-mode?
hazn: thanks for always being very responsive btw 😄
Kyle Mathews: yeah we've discussed adding built-in persistance but it's pretty hard and not a priority for v1 of DB — but it's definitely doable (albeit it's a very different model to develop in from server-first paradigms that most people work in (as you probably know))

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5ddcc4d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pkg-pr-new]

More templates

• todos
• @tanstack/db-example-solid-todo
• tanstack-start-example-basic
• @tanstack/db-example-paced-mutations-demo
• tanstack-start-db-projects-example
• @tanstack/db-example-react-todo

@tanstack/angular-db

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

@tanstack/db

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

@tanstack/db-ivm

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

@tanstack/electric-db-collection

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

@tanstack/offline-transactions

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

@tanstack/powersync-db-collection

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

@tanstack/query-db-collection

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

@tanstack/react-db

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

@tanstack/rxdb-db-collection

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

@tanstack/solid-db

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

@tanstack/svelte-db

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

@tanstack/trailbase-db-collection

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

@tanstack/vue-db

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

commit: 5ddcc4d