Terminal
Terminal/Skill
Patterns for Saleor's GraphQL API in storefronts, covering products, variants, checkout, channels and permissions.
By Saleor
Works with
npx skills add saleor/agent-skills --skill saleor-storefrontUniversal 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.
Reference these guidelines when:
useLegacyShippingZoneStockAvailability)| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | API | CRITICAL | api- |
| 2 | Products | HIGH | products- |
| 3 | Checkout | HIGH | checkout- |
| 4 | Channels | MEDIUM | channels- |
api-data-model — Nullable fields, pricing structure, automatic storefront filteringapi-permissions — Token types, permission errors, two-tier query patternapi-graphql-patterns — Channel-scoped queries, variant attributes, filtering, codegenapi-investigation — How to investigate Saleor API behavior via types and sourceproducts-variants — Variant model, selection vs non-selection attributes, pricing, UX patternscheckout-lifecycle — Session lifecycle, common errors, debugging payment issueschannels-purchasability — Stock availability modes (legacy vs direct, 3.23+), purchasability vs shippability, fulfillment triangle, mode-aware checklists, channel-scoped queries, stock webhooksRead individual rule files for detailed explanations and code examples:
rules/api-data-model.md
rules/products-variants.md
Each rule file contains:
For the complete guide with all rules expanded: AGENTS.md