ce

LLM Docs Header: All requests to https://llm-docs.commercengine.io must include the Accept: text/markdown header (or append .md to the URL path). Without it, responses return HTML instead of parseable markdown.

Commerce Engine Skills Router

These skills cover B2C storefronts. B2B storefronts use the same SDK patterns plus customer-group-aware pricing and headers.

Current SDK Mental Model

All frameworks install @commercengine/storefront — a unified package with subpath exports per framework:

• SPA (@commercengine/storefront): createStorefront(...) → storefront.public() / storefront.session()
• Next.js (@commercengine/storefront/nextjs): createNextjsStorefront(...) → storefront.publicStorefront() / storefront.clientStorefront() / await storefront.serverStorefront()
• TanStack Start (@commercengine/storefront/tanstack-start): createTanStackStartStorefront(...) → storefront.publicStorefront() / storefront.clientStorefront() + server entry for serverStorefront()

Core principle: public reads use the public accessor (API-key-backed, build-safe). Live session flows (auth, cart, orders) use the session/client/server accessor.

By Task

Setting up the SDK -> ce-setup

• Framework detection and SDK install
• Session storage selection
• Environment variables and one-config setup

Authentication & login -> ce-auth

• Anonymous session bootstrap
• OTP login, password login, password registration, password reset
• Account/profile flows

Products & catalog -> ce-catalog

• Products, categories, variants, search
• Reviews and recommendations

Cart & checkout -> ce-cart-checkout

• Hosted Checkout (recommended)
• Custom checkout (advanced)
• Cart CRUD, coupons, loyalty points, payments

Orders & returns -> ce-orders

• Order creation, order history, shipments, payments
• Cancellation and returns

Webhooks & events -> ce-webhooks

• Event handling, signature verification, async processing

Next.js / TanStack Start / Astro / SvelteKit patterns -> ce-ssr-patterns

• publicStorefront() / clientStorefront() / serverStorefront()
• Bootstrap, Server Actions/functions, pre-rendering, token management
• Concrete references for Next.js, TanStack Start, Astro, and SvelteKit

SEO & structured data -> ce-seo

• Head metadata, JSON-LD (Product/ProductGroup with variesBy), canonical URLs
• robots.txt, sitemaps, llms.txt, and Markdown mirrors for AI crawlers
• Server-mount vs prebuild, per deployment mode

AI agent tools (WebMCP) -> ce-ai

• Catalog, cart, navigation and session tools via document.modelContext
• Capability gating, cart semantics, and where the agent boundary sits

Custom SSR bindings -> ce-ssr

• @commercengine/ssr-utils for frameworks without a first-party wrapper (Nuxt, etc.)
• ServerTokenStorage and CookieAdapter
• Public build reads vs live request sessions

Storefront Pages

Canonical pages for a CE storefront and the skills/methods each needs:

Page	Example Route	Skills	Key SDK Methods
Home	/	catalog	listProducts, listCategories, recommendations
Product Listing	/products, /categories/[slug]	catalog	searchProducts, listProducts
Product Detail	/products/[slug]	catalog	getProductDetail, listProductVariants, listProductReviews
Cart	Hosted Checkout drawer or /cart	cart-checkout	useCheckout().openCart() or sdk.cart.*
Checkout	Hosted Checkout drawer or /checkout	cart-checkout	useCheckout().openCheckout() or custom checkout flow
Login	/login	auth	loginWithEmail, loginWithPhone, verifyOtp, loginWithPassword
Account	/account	auth	getUserDetails, updateUserDetails, changePassword
Orders	/account/orders	orders	listOrders
Order Detail	/account/orders/[id]	orders	getOrderDetails, listOrderShipments, listOrderPayments
SEO assets	/robots.txt, /sitemap.xml, /llms.txt	seo	createCommerceSeo, mounted handler or prebuild
Markdown mirrors	/product/[slug].md	seo	productMarkdown, content negotiation on the canonical URL

Converting an Existing Project

1. Install SDK - Follow ce-setup. Install @commercengine/storefront.
2. Replace public catalog reads first - Move listing/detail/category pages to publicStorefront() / public().
3. Add session-aware flows - Auth, cart, checkout, account, orders should use clientStorefront() / serverStorefront() / session().
4. Adopt Hosted Checkout or custom checkout - Follow ce-cart-checkout.
5. Add framework-specific SSR behavior if needed - ce-ssr-patterns (Next.js / TanStack Start / Astro / SvelteKit) or ce-ssr (custom bindings for Nuxt, etc.).

Replace one data source at a time. Keep existing UI components where possible and swap the data layer first.

Decision Tree

User Request
    │
    ├─ "Set up SDK" / "Add Commerce Engine"          → ce-setup
    ├─ "Login" / "Auth" / "OTP"                      → ce-auth
    ├─ "Products" / "Categories" / "Search"          → ce-catalog
    ├─ "Cart" / "Checkout" / "Payments"              → ce-cart-checkout
    ├─ "Orders" / "Returns" / "Shipments"            → ce-orders
    ├─ "Webhooks" / "Events" / "Sync"                → ce-webhooks
    ├─ "Next.js" / "Server Actions"                  → ce-ssr-patterns (references/nextjs.md)
    ├─ "TanStack Start" / "Server functions"         → ce-ssr-patterns (references/tanstack-start.md)
    ├─ "Astro" / "Astro SSR"                         → ce-ssr-patterns (references/astro.md)
    ├─ "SvelteKit" / "Svelte" / "Load functions"     → ce-ssr-patterns (references/sveltekit.md)
    ├─ "SSR" / "Cookies" / "Custom binding"          → ce-ssr
    ├─ "SEO" / "Sitemap" / "JSON-LD" / "llms.txt"    → ce-seo
    └─ "WebMCP" / "Agent tools" / "AI shopping"      → ce-ai

Quick Navigation

• /ce-setup
• /ce-auth
• /ce-catalog
• /ce-cart-checkout
• /ce-orders
• /ce-webhooks
• /ce-ssr-patterns
• /ce-ssr
• /ce-seo
• /ce-ai