Saleor Configurator
Saleor Configurator patterns for managing store configuration as code.
by saleor · MIT
The skill
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.
Saleor Configurator
Guide for using Saleor Configurator — a "commerce as code" CLI that lets you define your entire Saleor store configuration in YAML and deploy it declaratively.
When to Apply
- Writing or editing
config.ymlfor a Saleor store - Running
deploy,introspect, ordiffcommands - Understanding which identifier to use (
slugvsname) for each entity - Debugging mismatches between local config and remote state
- Setting up CI/CD pipelines for automated deployments
- Migrating store configuration between environments
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Config Schema | CRITICAL | config- |
| 2 | Entity Identity | CRITICAL | identity- |
| 3 | CLI Workflow | HIGH | cli- |
| 4 | Deployment | HIGH | deploy- |
| 5 | Diff & Sync | MEDIUM | diff- |
Quick Reference
1. Config Schema (CRITICAL)
config-schema— YAML structure, all top-level keys, entity examples
2. Entity Identity (CRITICAL)
identity-strategies— Slug-based vs name-based vs singleton; which entity uses which
3. CLI Workflow (HIGH)
cli-commands— All commands, flags, env vars, credential setup, non-interactive mode
4. Deployment (HIGH)
deploy-pipeline— Stage order, dependency graph, selective deployment, failure handling
5. Diff & Sync (MEDIUM)
diff-behavior— How diff detects changes, what triggers create/update/delete
How to Use
Read individual rule files for detailed explanations and examples:
rules/config-schema.md
rules/identity-strategies.md
rules/cli-commands.md
rules/deploy-pipeline.md
rules/diff-behavior.md
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
Use this skill
Connect your agent to the Skill Store MCP server and ask for it by ref: saleor/saleor-configurator-19408659197.
Details
- Publisher
- saleor
- Category
- Software Development › DevOps & cloud
- License
- MIT
- Updated
- 2026-08-06
References
More from saleor
- Saleor App Universal Saleor app development patterns.
- Saleor Core Saleor backend internals and behavior reference.
- Saleor Storefront Saleor e-commerce API patterns for building storefronts.
- Storefront Builder Saleor storefront data + UX playbook.