docs(tutorials): storefront typed cart/checkout frontend chapter + series polish#684
Merged
Conversation
…roposal #6) Add 06-storefront-ui.md showcasing the frontend typed spine the storefront series never touched: a bound route contract (createRouteReference / defineRouteContract / bindRoutePattern), a per-service createServiceClient + createServiceQueryUtils clients module, and a Fresh island reading with useIslandQuery and beginning checkout with useIslandMutation. Deploy renumbered 06 -> 07; prev/next/learningPath/xref navigation rewired across the series. Every API grounded via deno doc + two scratch deno checks against packages/sdk and packages/fresh; the island uses contract-derived keys with typed client calls (the SDK queryOptions/mutationOptions result is not raw-spreadable into the zero-arg island hooks). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
…ng, PORT note - index.md: name the differentiator the series proves + a 'what this replaces' contrast sentence (proposal #17). - 02-catalog-service.md: note that Aspire injects PORT and services.<name>.port in netscript.config.ts is the typed source of truth (proposal #7). - 07-deploy.md one-command scaffold-to-Aspire framing shipped with commit 1; worklog records the full run. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VifzAytcxBk5odEMaCXihM
rickylabs
added
area:docs
status:impl-eval
type:docs
priority:p1
rickylabs
marked this pull request as ready for review
July 11, 2026 22:27
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #661 (storefront rollout slice — headline of the wave)
Adds the missing storefront FRONTEND chapter (audit proposal 6): new
06-storefront-ui.md— typed cart route + typed checkout mutation through the sdk seam (contract-derived keys fromcreateServiceQueryUtils+ typed client calls as the hook bodies, with an honest callout: scratchdeno checkproved the utils'queryOptions()/mutationOptions()results are not raw-spreadable into the island hooks, so the chapter teaches the real seam, not a fiction). Deploy renumbered to ch07 with the one-command Aspire framing (proposal 18); series learningPaths renumbered; index lede names the differentiator + contrast (proposal 17); ch02 PORT typed-config note; xref map updated.New chapter code:prose 42% (within the 25–45% MedusaJS band). Validation: docs verify green — 170 pages (169 + the new chapter) / 23,624 links; grep gate 0 hits; no stale deploy refs (worklog in-branch at
.llm/runs/docs-661a-storefront--opus/).Authored by a Claude Opus 4.8 docs agent under the beta-8 orchestrator (
4d300496); Tier-A reviewed.