// Universal Saleor app development patterns. Covers the app protocol (manifest, registration, webhooks, authentication), SDK abstractions, settings persistence, and Dashboard integration. Framework-agnostic with Next.js examples.
Saleor backend internals and behavior reference. Covers discount precedence, stock availability modes (legacy vs direct, 3.23+), Dashboard UI rules, webhook trigger conditions, denormalized field semantics, and migration footguns. Use when working with Saleor discounts or stock availability, building Dashboard UI, or debugging backend behavior.
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.
Saleor storefront data + UX playbook. Covers GraphQL query design, channel handling, data contracts per surface (PLP/PDP/nav/pricing/availability/media), variant-selection UX, and Saleor-specific correctness rules. Framework-agnostic — agent inspects repo and applies conventions locally.
Saleor Configurator patterns for managing store configuration as code. Use when writing config.yml, running deploy/introspect/diff commands, understanding entity identification (slug vs name), deployment pipeline order, or debugging sync issues.
| name | saleor-app |
| description | Universal Saleor app development patterns. Covers the app protocol (manifest, registration, webhooks, authentication), SDK abstractions, settings persistence, and Dashboard integration. Framework-agnostic with Next.js examples. |
| license | MIT |
| metadata | {"author":"saleor","version":"1.0.0"} |
Guide for building apps that extend Saleor via webhooks and the GraphQL API.
Framework-agnostic protocol documentation with Next.js examples using @saleor/app-sdk.
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Protocol | CRITICAL | protocol- |
| 2 | Permissions | CRITICAL | permissions- |
| 3 | Webhooks | HIGH | webhook- |
| 4 | Data & Settings | HIGH | data- |
| 5 | Dashboard UI | MEDIUM | dashboard- |
| 6 | Development | MEDIUM | dev- |
protocol-manifest — App manifest, required endpoints, permissions, extensionsprotocol-auth — Registration handshake, APL, token scopes, JWT/signature verificationpermissions-access-scopes — User scope vs app scope, client-side permission checks, JWT middleware patternswebhook-async — Async event handling, payload typing, retry policy, signature verificationwebhook-sync — Sync event handling, response schemas, performance constraintswebhook-external — Receiving webhooks from external services, multi-tenant routingdata-graphql — GraphQL from apps: client setup, auth headers, codegen, app vs user tokensdata-settings — MetadataManager, EncryptedMetadataManager, domain-scoped persistencedashboard-appbridge — AppBridge iframe protocol, actions, events, theme/locale syncdev-debug — Common errors, webhook dry runs, tunnel setup, debugging checklist