Saleor Storefront

Universal guide for building storefronts on the Saleor e-commerce platform. Covers the Saleor GraphQL API data model, permission system, checkout lifecycle, channel architecture, and product/variant patterns. Framework-agnostic — these rules apply whether you're using Next.js, Remix, Nuxt, or a custom setup.

When to Apply

Reference these guidelines when:

• Querying Saleor's GraphQL API for products, categories, or collections
• Building product detail pages with variant selection
• Implementing checkout and payment flows
• Working with multi-channel and multi-currency setups
• Debugging "product not purchasable" or permission errors
• Working with Saleor 3.23+ stock availability modes (useLegacyShippingZoneStockAvailability)
• Investigating Saleor API behavior via source code