saleor-storefront
saleor/agent-skills
Saleor GraphQL API patterns for building e-commerce storefronts across any framework.
What is saleor-storefront?
Reference guide for building storefronts on Saleor's e-commerce platform. Covers GraphQL API data models, product variants, checkout flows, multi-channel setups, permissions, and stock availability. Framework-agnostic and applies to Saleor 3.23+.
- Query Saleor's GraphQL API for products, categories, and collections
- Build product detail pages with variant selection and pricing
- Implement checkout and payment flows with session lifecycle management
- Configure multi-channel and multi-currency setups
- Debug permission errors and product purchasability issues
- Work with stock availability modes and fulfillment logic
How to install saleor-storefront
npx skills add https://github.com/saleor/agent-skills --skill saleor-storefrontHow to use saleor-storefront
- 1.Review the rule categories (API, Products, Checkout, Channels) by priority
- 2.Read individual rule files (api-data-model.md, products-variants.md, etc.) for your use case
- 3.Apply code examples and patterns to your storefront queries and mutations
- 4.Reference the full compiled AGENTS.md document for complete expanded rules
- 5.Use channel-scoped queries and permission checks when building multi-tenant features
Use cases
- Building a Next.js or Remix storefront on Saleor
- Implementing product variant selection with correct attribute filtering
- Setting up checkout flows and payment integrations
- Configuring channel-specific pricing and stock availability
- Debugging 'product not purchasable' errors in Saleor 3.23+
- Frontend developers building Saleor storefronts
- Full-stack engineers implementing e-commerce platforms
- Developers migrating to or debugging Saleor 3.23+ stock modes
- Teams using Next.js, Remix, Nuxt, or custom frameworks with Saleor
saleor-storefront FAQ
None — it's framework-agnostic and applies to any Saleor storefront built with Next.js, Remix, Nuxt, or custom setups.
Primarily Saleor 3.23+ with specific guidance on stock availability modes and legacy vs. direct stock availability.
Check the channels-purchasability rule for stock availability modes, fulfillment triangle logic, and channel-scoped query patterns.
It covers checkout lifecycle and session management; payment provider integration details are outside this skill's scope.
The full compiled document with all rules expanded is in AGENTS.md; individual rules are in the rules/ directory.
Full instructions (SKILL.md)
Source of truth, from saleor/agent-skills.
name: saleor-storefront description: > Saleor e-commerce API patterns for building storefronts. Use when working with Saleor's GraphQL API, products, variants, checkout, channels, permissions, or debugging API behavior. Framework-agnostic — applies to any Saleor storefront. license: MIT metadata: author: saleor version: "1.0.0"
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
Rule Categories
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | API | CRITICAL | api- |
| 2 | Products | HIGH | products- |
| 3 | Checkout | HIGH | checkout- |
| 4 | Channels | MEDIUM | channels- |
Quick Reference
1. API (CRITICAL)
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 source
2. Products (HIGH)
products-variants— Variant model, selection vs non-selection attributes, pricing, UX patterns
3. Checkout (HIGH)
checkout-lifecycle— Session lifecycle, common errors, debugging payment issues
4. Channels (MEDIUM)
channels-purchasability— Stock availability modes (legacy vs direct, 3.23+), purchasability vs shippability, fulfillment triangle, mode-aware checklists, channel-scoped queries, stock webhooks
How to Use
Read individual rule files for detailed explanations and code examples:
rules/api-data-model.md
rules/products-variants.md
Each rule file contains:
- Brief explanation of why it matters
- Code examples (correct and incorrect patterns)
- Anti-patterns to avoid
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
Related skills
More from saleor/agent-skills and the wider catalog.
agent-kanban
Manage assigned Agent Kanban v2 tasks within an Agency Session using Realmroot identity.
golang-benchmark
Measure Go performance with benchmarks, profiling, and statistical rigor.
golang-cli
Build production Go CLI tools with Cobra, Viper, and Unix best practices.
golang-code-style
Go code style conventions: line length, variable declarations, control flow clarity, and when comments help.
golang-concurrency
Design and audit Go concurrency: goroutines, channels, mutexes, worker pools, and leak prevention.
golang-context
Idiomatic context.Context propagation, cancellation, timeouts, and request-scoped values in Go.