All Shopify GraphQL goes through lib/shopify/storefront-client.ts (server-only).
Cart created lazily on first add; cart id stored in HttpOnly cookie cart_id.
Mutations (add / update / remove) via POST /api/cart. Client uses useCart() (SWR).
Out-of-stock: query availableForSale + quantityAvailable; disable AddToCartButton.
Discount codes: POST /api/cart/discount → cartDiscountCodesUpdate. Surface userErrors.
Checkout: top-level navigation to cart.checkoutUrl. Attach buyerIdentity.customerAccessToken when logged in.
Cache via next: { tags: ["product:<handle>"], revalidate: 60 }. Webhooks call revalidateTag.

이 저장소의 다른 Skills

같은 저장소

core-ui-migration

JasonYangCIS/builder-nextjs-shopify

How to move an app component into the headless @jasonyangcis/core-ui library — headless conversion, cross-repo file checklist, treeshake sentinel, changeset, consumer wiring.

2026-06-090

builder-page-wiring

JasonYangCIS/builder-nextjs-shopify

How to wire a new Builder.io-rendered route or model — fetch helper, route, registry, config.

2026-04-290

route-handlers

JasonYangCIS/builder-nextjs-shopify

Pattern for adding a server Route Handler under app/api/** — origin check, zod body, server-only deps, safe responses.

2026-04-290

builder-io

JasonYangCIS/builder-nextjs-shopify

Builder.io Gen-2 SDK patterns — fetch, render, register, model guard, preview.