Tutorials

Task-focused, end-to-end recipes for building a storefront on Orchard. Each one is self-contained and uses real /api/v1 calls.

Recipe	You’ll build
Show a product catalog	A listing page and a product detail page, with images and reviews.
Cart to checkout to order	A cart, a hosted Stripe checkout, and the order-confirmation handoff.
Customer sign-in (magic link)	Passwordless customer accounts and an authenticated session.
Receive webhooks	A verified webhook endpoint that reacts to `order.paid`.

Before you start

You need a tenant slug and test-mode keys (sk_test_… / pk_test_…) from the Orchard operator, and the test base URL:

https://api-test.theorchard.dev/api/v1

Set it as NEXT_PUBLIC_ORCHARD_API (or your framework’s equivalent) and keep secret keys server-side only. See the Developer quickstart for the five-minute version and Authentication for the key model.

Which key where? Use pk_test_* for browser-safe reads and checkout:write; use sk_test_* only on your server. Never ship an sk_ key in the browser bundle.

Show a product catalog