Skip to content

docs: correct cart implementation details - #515

Merged
laugharn merged 2 commits into
mainfrom
fix/cart-documentation-drift
Aug 21, 2026
Merged

docs: correct cart implementation details#515
laugharn merged 2 commits into
mainfrom
fix/cart-documentation-drift

Conversation

@laugharn

Copy link
Copy Markdown
Collaborator

Summary

  • point the cart streaming documentation to seedCartData() in lib/cart/server.ts
  • replace the unused Hydrogen cart-form description with the current direct /api/cart fetch flow
  • document the standard line-update event and local discount-resolution event used by the implementation

Verification

  • pnpm --dir apps/docs exec oxfmt --check content/docs/anatomy/cart.mdx
  • confirmed the docs contain no references to lib/cart/seed.ts, useCartForm(), formProps(), or register()
  • git diff --check

@vercel

vercel Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
Image shop-docs Ready Ready Preview Aug 21, 2026 2:51pm
Image shop-template Ready Ready Preview, v0 Aug 21, 2026 2:51pm

@laugharn
laugharn merged commit 1e6c676 into main Aug 21, 2026
5 of 7 checks passed
@laugharn
laugharn deleted the fix/cart-documentation-drift branch August 21, 2026 14:50
laugharn added a commit that referenced this pull request Aug 24, 2026
* Replace hand-rolled WebMCP with Hydrogen's behind a config flag (#504)

* Revert "add experimental WebMCP storefront tools (#498)"

This reverts commit 600e9ff.

Removes the hand-rolled WebMCP implementation, its README/AGENTS-adjacent
docs, env token, i18n strings, and cart-client support code. A follow-up
PR will implement Hydrogen's WebMCP behind a config flag instead.

* feat(template): add Hydrogen WebMCP behind webmcp.isEnabled config flag

Replaces the reverted hand-rolled WebMCP implementation with Hydrogen's
own. Setting webmcp.isEnabled in lib/config.ts makes the existing
ShopifyScripts component load Shopify's storefront webmcp.js on browsers
that expose document.modelContext.

The Shopify analytics script is now gated independently
(shopifyAnalytics) so WebMCP works without enabling analytics, and the
shared ShopifyScripts mount turns on when either feature needs it.

* Drop README note; rename ShopifyAnalyticsTracker to ShopifyScriptsTracker

The README bullet doesn't fit the repo's docs style. The component now
mounts ShopifyScripts for WebMCP too, so name it after what it renders.

* TEMP: enable webmcp by default for preview deployment

* docs: document experimental WebMCP feature

Adds an anatomy page for WebMCP with an explicit experimental
designation (in-progress browser API, Chrome-flag-only, disabled by
default), testing instructions, and a webmcp section in the shop-config
reference alongside the other isEnabled flags.

* Revert "TEMP: enable webmcp by default for preview deployment"

This reverts commit c40f6d1.

* Keep storefront detail navigation stable (#506)

* fix(template): allow blocking product routes

* fix(template): allow blocking content routes

* fix(docs): drop env vars from the deploy button URL (#502)

* chore(docs): update Geistdocs to 1.20.4 (#508)

* chore(docs): update Geistdocs to 1.20.4

* chore(docs): allow agent readability releases

* fix(template): scope Shopify proxy routes (#505)

* fix(template): proxy Shopify consent requests locally

* chore(template): mount Hydrogen scripts by default

* fix(template): provide consent banner access token

* refactor(template): render consent token as script content

* fix(template): proxy versioned Storefront API routes

* chore(template): update Hydrogen preview

* experiment(template): use Hydrogen cart proxy handler

* refactor(template): delegate Shopify routes in proxy

* fix(template): scope Shopify proxy routes

* chore: bump dependencies

* chore: enforce release age for Hydrogen

* feat(template): complete Hydrogen cart integration (#512)

* feat(template): attribute carts to customer sessions

* fix(template): settle concurrent cart totals

* fix(template): update pending cart lines

* feat(template): attribute carts to storefronts

* fix(template): avoid duplicate page views

* fix(template): preserve cart line attributes

* fix(template): omit invalid storefront ID

* feat(template): track cart analytics (#513)

* fix(template): integrate Hydrogen discount updates (#514)

* fix(template): use Hydrogen discount forms

* fix(template): submit discount updates

* fix(template): preserve cart mutation errors

* feat(template): show line item discounts

* fix(template): refine cart discount display

* docs: correct cart implementation details (#515)

* refactor(template): remove cart seed shim (#516)

* Adopt Hydrogen storefront primitives (#524)

* Use Hydrogen predictive search

* Use Hydrogen collection browse state

* Fix taxonomy collection filters

* Remove legacy collection filter URLs

* Add Hydrogen storefront analytics events

* Preserve predictive search loading state

* Adopt Hydrogen cart form primitives

* Adopt Hydrogen storefront logging

* Start 2026-08-23 Hydrogen release

* Format integrated Hydrogen docs

* Scope client translation messages

* Rewrite docs around essential user outcomes

* Restore next-step guidance in feature docs

* Codify reader-focused docs endings

* Provide search client translations

* Improve template agent readability (#527)

* Improve template agent readability

* Remove template test scaffolding

* Upgrade template dependencies (#528)

* Restore full-bleed collection heroes

* Allow server actions through content negotiation

---------

Co-authored-by: Boris Besemer <borisbesemer@gmail.com>
Co-authored-by: Rich Haines <rich@vercel.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant