docs: Replace atomic mutations with ACID integrity concept by ntucker · Pull Request #4070 · reactive/data-client

ntucker · 2026-08-12T19:04:20Z

Summary

Replace the Atomic Mutations concept page with an ACID page covering atomicity, consistency, isolation, and durability for async frontend data
Add interactive playgrounds for update/create/delete, rollback, identity, collections, query, validation, transports, fetch-order, snapshots, and REST durability
Redirect /docs/concepts/atomic-mutations to /docs/concepts/acid and update GOALS, Entity, mutations, and homepage demo links

Test plan

Visit /docs/concepts/acid and confirm playgrounds render and run
Confirm /docs/concepts/atomic-mutations redirects to the new page
Check the Concepts sidebar shows ACID
Follow the homepage demo “atomically and immediately” link to the ACID page

Made with Cursor

Explain atomicity, consistency, isolation, and durability for async frontend data, with interactive demos and a redirect from the old page. Co-authored-by: Cursor <cursoragent@cursor.com>

changeset-bot · 2026-08-12T19:04:25Z

⚠️ No Changeset found

Latest commit: d6687de

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

vercel · 2026-08-12T19:04:27Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs-site	Ignored	Preview	Aug 17, 2026 4:58pm

github-actions · 2026-08-12T19:06:22Z

Size Change: 0 B

Total Size: 81 kB

ℹ️ View Unchanged

Filename	Size
`examples/test-bundlesize/dist/App.js`	1.46 kB
`examples/test-bundlesize/dist/polyfill.js`	307 B
`examples/test-bundlesize/dist/rdcClient.js`	10.9 kB
`examples/test-bundlesize/dist/rdcEndpoint.js`	8.07 kB
`examples/test-bundlesize/dist/react.js`	59.6 kB
`examples/test-bundlesize/dist/webpack-runtime.js`	784 B

_{compressed-size-action}

codecov · 2026-08-12T19:08:26Z

Codecov Report

❌ Patch coverage is 88.70968% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 97.48%. Comparing base (ef4653f) to head (d6687de).

Files with missing lines	Patch %	Lines
...site/src/components/DemoVideo/useAutoplayInView.ts	87.00%	6 Missing and 7 partials ⚠️
website/src/components/DemoVideo/reducePlayback.ts	94.11%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #4070      +/-   ##
==========================================
- Coverage   97.84%   97.48%   -0.36%     
==========================================
  Files         156      160       +4     
  Lines        3057     3181     +124     
  Branches      612      638      +26     
==========================================
+ Hits         2991     3101     +110     
- Misses         18       24       +6     
- Partials       48       56       +8

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Reuse the existing optimistic-transform demo and list interceptor instead of copying them, and point durability at the managers persist example. Co-authored-by: Cursor <cursoragent@cursor.com>

Avoid dual @types/react mismatch between Docusaurus SVG modules and React.ComponentProps<'svg'>. Co-authored-by: Cursor <cursoragent@cursor.com>

Replace duplicate todo lists with list+detail issues and a bundled trade/account mutation so each guarantee shows up in a recognizable product UI. Co-authored-by: Cursor <cursoragent@cursor.com>

The working case looks uneventful unless tearing is visible beside it. Co-authored-by: Cursor <cursoragent@cursor.com>

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 7ab1e09. Configure here.}

Hazard stripes and raw buttons made tearing look like a wireframe; a quiet left-rule, chip, and toolbar make the contrast readable. Co-authored-by: Cursor <cursoragent@cursor.com>

Matches the intro's flat-file analogy: a store with no data model, not a vague "typical" cache. Co-authored-by: Cursor <cursoragent@cursor.com>

Keep the navigator and Data Client pane mounted when switching payloads instead of suspending the whole playground. Co-authored-by: Cursor <cursoragent@cursor.com>

thead cells need a tr/th, and MDX table rows must use className. Co-authored-by: Cursor <cursoragent@cursor.com>

Readers see the mutation first, then click into the live playground and can reveal the code that builds it. Co-authored-by: Cursor <cursoragent@cursor.com>

Gate autoplay on viewport ratio and document visibility, pause on scroll-out or tab backgrounding, and drop the Demo header from the video facade. Persist DemoVideo tests in CircleCI. Co-authored-by: Cursor <cursoragent@cursor.com>

github-actions · 2026-08-17T16:46:46Z

Size Change: 0 B

Total Size: 81 kB

ℹ️ View Unchanged

Filename	Size
`examples/test-bundlesize/dist/App.js`	1.46 kB
`examples/test-bundlesize/dist/polyfill.js`	307 B
`examples/test-bundlesize/dist/rdcClient.js`	10.9 kB
`examples/test-bundlesize/dist/rdcEndpoint.js`	8.07 kB
`examples/test-bundlesize/dist/react.js`	59.6 kB
`examples/test-bundlesize/dist/webpack-runtime.js`	784 B

_{compressed-size-action}

Gives agents a structured workflow to rank and refine falsifiable demo concepts instead of narrative-heavy showcases. Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Replace atomic mutations with ACID integrity concept

f74ba7e

Explain atomicity, consistency, isolation, and durability for async frontend data, with interactive demos and a redirect from the old page. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 12, 2026 19:05 View deployment

cursor Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread docs/core/shared/_acidValidate.mdx

docs: Deduplicate ACID playgrounds and persist example

d414bcd

Reuse the existing optimistic-transform demo and list interceptor instead of copying them, and point durability at the managers persist example. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 12, 2026 19:52 View deployment

fix(website): Type homepage SVGs from SVGR imports

1ea3b0b

Avoid dual @types/react mismatch between Docusaurus SVG modules and React.ComponentProps<'svg'>. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 13, 2026 15:10 View deployment

docs: Use issue-tracker and trade playgrounds for ACID

6861743

Replace duplicate todo lists with list+detail issues and a bundled trade/account mutation so each guarantee shows up in a recognizable product UI. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 13, 2026 15:36 View deployment

cursor Bot reviewed Aug 13, 2026

View reviewed changes

Comment thread docs/core/shared/_acidCreate.mdx Outdated

Comment thread docs/core/shared/_acidDelete.mdx

docs: Contrast ACID playgrounds with typical independent caches

7ab1e09

The working case looks uneventful unless tearing is visible beside it. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 13, 2026 16:03 View deployment

cursor Bot reviewed Aug 13, 2026

View reviewed changes

Comment thread docs/core/shared/_acidValidate.mdx

Comment thread docs/core/shared/_acidValidate.mdx

docs: Restyle ACID playgrounds as stacked instrument panes

85455d5

Hazard stripes and raw buttons made tearing look like a wireframe; a quiet left-rule, chip, and toolbar make the contrast readable. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 13, 2026 16:24 View deployment

docs: Call the ACID contrast a flat cache

e7d08b2

Matches the intro's flat-file analogy: a store with no data model, not a vague "typical" cache. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 14, 2026 15:46 View deployment

root and others added 3 commits August 14, 2026 11:56

docs: Isolate ACID validate raw pane suspense

c526c8e

Keep the navigator and Data Client pane mounted when switching payloads instead of suspending the whole playground. Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Fix invalid table markup that caused hydration warnings

bf40862

thead cells need a tr/th, and MDX table rows must use className. Co-authored-by: Cursor <cursoragent@cursor.com>

docs: Start the ACID update playground as a video demo

f4ba460

Readers see the mutation first, then click into the live playground and can reveal the code that builds it. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview August 17, 2026 16:24 View deployment

vercel Bot deployed to Preview August 17, 2026 16:46 View deployment

chore: Add a skill for designing capability demos

d6687de

Gives agents a structured workflow to rank and refine falsifiable demo concepts instead of narrative-heavy showcases. Co-authored-by: Cursor <cursoragent@cursor.com>

Navigation Menu

Uh oh!

Uh oh!

docs: Replace atomic mutations with ACID integrity concept - #4070

docs: Replace atomic mutations with ACID integrity concept#4070
ntucker wants to merge 12 commits into
masterfrom
docs/acid

ntucker commented Aug 12, 2026

Uh oh!

changeset-bot Bot commented Aug 12, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Aug 12, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 12, 2026

Uh oh!

codecov Bot commented Aug 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Aug 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

ntucker commented Aug 12, 2026

Summary

Test plan

Uh oh!

changeset-bot Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Aug 12, 2026

Uh oh!

codecov Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Aug 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

changeset-bot Bot commented Aug 12, 2026 •

edited

Loading

vercel Bot commented Aug 12, 2026 •

edited

Loading

codecov Bot commented Aug 12, 2026 •

edited

Loading