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

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

⚠️ No Changeset found

Latest commit: b2435c4

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 19, 2026 5:21pm

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 (be7ae1a) to head (b2435c4).

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.

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}

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>

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>

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>

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

Keep the new shared skill on the vendor-neutral path so Cursor, Codex, and other agents discover it after the master move. Co-authored-by: Cursor <cursoragent@cursor.com>

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

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

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

cursor · 2026-08-19T17:25:01Z

+      pendingUserPlay.current = false;
+      void play();
+    }
+  }, [attachSources, play]);


Autoplay aborted by source reload

Medium Severity

When sources first attach, useAutoplayInView can call play() in an earlier effect while this effect then calls video.load(). That resets the element and rejects the in-flight play(), which is treated as blocked. In-view facades therefore stay on the poster until the user presses Play.

Additional Locations (1)

website/src/components/DemoVideo/useAutoplayInView.ts#L53-L79

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

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

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

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

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

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

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

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

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

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

root and others added 12 commits August 19, 2026 13:18

docs: Replace atomic mutations with ACID integrity concept

077b355

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>

docs: Deduplicate ACID playgrounds and persist example

7ac61cc

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>

fix(website): Type homepage SVGs from SVGR imports

fa2886a

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

docs: Use issue-tracker and trade playgrounds for ACID

2963d73

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>

docs: Contrast ACID playgrounds with typical independent caches

508553a

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

docs: Restyle ACID playgrounds as stacked instrument panes

b21fa7d

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>

docs: Call the ACID contrast a flat cache

a8a3744

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>

docs: Isolate ACID validate raw pane suspense

64e5e43

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

f4b8a3c

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

8101a31

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>

chore: Add a skill for designing capability demos

6b6740d

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

ntucker force-pushed the docs/acid branch from d6687de to 6b6740d Compare August 19, 2026 17:19

internal: Move design-capability-demos skill to .agents/skills/

b2435c4

Keep the new shared skill on the vendor-neutral path so Cursor, Codex, and other agents discover it after the master move. Co-authored-by: Cursor <cursoragent@cursor.com>

cursor Bot reviewed Aug 19, 2026

View reviewed changes

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 13 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!

Uh oh!

Uh oh!

github-actions Bot commented Aug 17, 2026

Uh oh!

cursor Bot left a comment

Uh oh!

cursor Bot Aug 19, 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!

Uh oh!

Uh oh!

github-actions Bot commented Aug 17, 2026

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Aug 19, 2026

Choose a reason for hiding this comment

Autoplay aborted by source reload

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