NextCommerceCo / NextCommerceCo/developer-docs

Document the cart to platform-checkout handoff with Spark as reference

Open
#34 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
MDX
Stars
2
Forks
0
Avg merge
6h 4m
Merged PRs (30d)
13

Description

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.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with content/docs/storefront/themes/templates/urls-and-template-paths.mdx, content/docs/storefront/graphql/index.mdx, and content/docs/storefront/themes/guides/product-variants.mdx, then inspect Spark's checkout, side-cart, and SparkVariantState references. Done means the handoff trigger, URL, cart-state behavior, side-cart example, and variant reference are linked clearly enough to trace add-to-cart through checkout from the docs alone.

Written by the indexing model from the issue text.

Assessment

Tech stack
graphql, javascript
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.