Problem: The weakest documented seam in the theme docs is the one merchants care about most: how a theme cart hands off to platform checkout. There is no page covering the handoff mechanics, no worked side-cart example, and the variant-selection JS reference points to an unlinked "Base Theme."
Evidence: content/docs/storefront/themes/templates/urls-and-template-paths.mdx (checkout template named, no handoff topic); content/docs/storefront/graphql/index.mdx (side carts called the most common use, no worked example); content/docs/storefront/themes/guides/product-variants.mdx (defers to an unlinked base theme).
Done when:
- A handoff page documents the cart-to-checkout transition: trigger, URL, and how cart state carries into
/checkout/.
- A side-cart tutorial exists with Spark's implementation linked as the public reference.
- The variant guide links Spark's
SparkVariantState as the reference implementation.
- An outside developer can trace add-to-cart through checkout handoff from docs alone.
Problem: The weakest documented seam in the theme docs is the one merchants care about most: how a theme cart hands off to platform checkout. There is no page covering the handoff mechanics, no worked side-cart example, and the variant-selection JS reference points to an unlinked "Base Theme."
Evidence:
content/docs/storefront/themes/templates/urls-and-template-paths.mdx(checkout template named, no handoff topic);content/docs/storefront/graphql/index.mdx(side carts called the most common use, no worked example);content/docs/storefront/themes/guides/product-variants.mdx(defers to an unlinked base theme).Done when:
/checkout/.SparkVariantStateas the reference implementation.