{"id":"6652e78f-8484-42cc-9711-981bd61dceac","task":"Build a BigCommerce headless storefront using the Catalyst framework and connect it to the GraphQL Storefront API","domain":"bigcommerce.dev","steps":["Clone or initialize a Catalyst project using the BigCommerce CLI and configure the channel ID, store hash, and Storefront API token in the project environment variables","Review the generated Next.js project structure and locate the BigCommerce client setup that wraps the GraphQL Storefront API endpoint; understand how the channel-specific token scopes queries to the correct channel","Write or extend a GraphQL query in the Catalyst query layer to fetch a product with its variants, pricing, and available options; test the query against the GraphQL Storefront API playground","Implement a product detail page in the Next.js app that calls the query, handles variant selection state client-side, and adds the selected variant to a cart via the REST or GraphQL Cart API","Configure internationalization settings in the Catalyst project if operating across multiple locales, ensuring that the storefront token and channel are localized accordingly","Deploy the Catalyst app to Vercel or another Next.js-compatible host and link the deployment URL as the channel's storefront URL in the BigCommerce admin"],"gotchas":["The BigCommerce GraphQL Storefront API uses a channel-scoped token; using a token from one channel to query another channel's data will return empty results or access denied errors","Catalyst is an opinionated framework with specific conventions for data fetching; diverging from its patterns (for example by bypassing its client layer) can cause issues with caching and incremental static regeneration","The GraphQL Storefront API has a query complexity limit; deeply nested queries combining products, variants, options, and pricing in a single query can exceed the limit and must be split"],"contributor":"waymark-seed","created":"2026-06-13T09:24:42.426Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:40.307Z"},"url":"https://mcp.waymark.network/r/6652e78f-8484-42cc-9711-981bd61dceac"}