# Saleor Commerce Documentation

> Saleor is an open-source, GraphQL-first, headless e-commerce platform. This documentation covers the API, integrations, and self-hosting.

## Quick Links

- Documentation: https://docs.saleor.io
- API Playground: https://docs.saleor.io/api-reference
- GitHub: https://github.com/saleor/saleor
- GraphQL Schema (latest stable): https://raw.githubusercontent.com/saleor/saleor/3.22/saleor/graphql/schema.graphql
- GraphQL Schema (main, may contain unreleased and unstable changes): https://raw.githubusercontent.com/saleor/saleor/main/saleor/graphql/schema.graphql

## Documentation Structure

### Quickstart
Getting started guides for new users.
- /quickstart/cloud - Set up a free Saleor Cloud sandbox
- /quickstart/api - First API calls and GraphQL basics
- /quickstart/storefront - Building a storefront
- /quickstart/running-locally - Local development setup

### Core Concepts
Business logic and data models.
- /developer/channels/overview - Multi-channel commerce (regions, currencies)
- /developer/products/overview - Products, variants, and catalog
- /developer/checkout/overview - Cart and checkout flow
- /developer/order/overview - Order management and fulfillment
- /developer/payments/overview - Payment processing and transactions
- /developer/discounts/overview - Promotions, vouchers, and sales
- /developer/stock/overview - Inventory and warehouse management
- /developer/users/overview - Customer and staff accounts

### GraphQL API
Using the Saleor API.
- /api-usage/overview - GraphQL introduction
- /api-usage/authentication - Auth tokens and permissions
- /api-usage/error-handling - Error codes and handling
- /api-usage/pagination - Cursor-based pagination
- /api-usage/filtering - Query filters
- /api-usage/metadata - Custom metadata on objects

### API Reference
Complete GraphQL schema documentation.
- /api-reference - Full API reference (queries, mutations, types)
- Organized by domain: products, checkout, orders, payments, users, webhooks, etc.

### Building Apps
Creating integrations and extending Saleor.
- /developer/extending/apps/overview - Apps architecture
- /developer/extending/apps/quickstart - Create your first app
- /developer/extending/webhooks/overview - Webhook events
- /developer/extending/webhooks/synchronous-events/overview - Sync webhooks (tax, shipping, payment)
- /developer/extending/apps/developing-apps/app-sdk/overview - App SDK reference

### Extensions (App Store)
Pre-built integrations.
- /developer/app-store/overview - Available apps
- /developer/app-store/apps/adyen/overview - Adyen payments
- /developer/app-store/apps/stripe/overview - Stripe payments
- /developer/app-store/apps/avatax/overview - Avalara tax automation
- /developer/app-store/apps/smtp/overview - Email sending

### Saleor Cloud
Managed hosting.
- /cloud/overview - Cloud features
- /cloud/environment - Environment management

### Self-Hosting
Running Saleor yourself.
- /setup/overview - Self-hosting guide
- /setup/docker-compose - Docker setup
- /setup/configuration - Environment variables

### Recipes
Implementation patterns for common use cases.
- /recipes/multi-region - Multi-region commerce
- /recipes/digital-products - Selling digital goods
- /recipes/marketplace - Multi-vendor marketplace
- /recipes/click-and-collect - Store pickup

## AI Integration

For AI agents working with Saleor:
- /developer/ai - MCP (Model Context Protocol) configuration
- GraphQL schema can be used with mcp-graphql for AI-assisted development

## Raw Documentation Access

Source MDX files are available at:
https://raw.githubusercontent.com/saleor/saleor-docs/main/docs/{path}.mdx

Example:
https://raw.githubusercontent.com/saleor/saleor-docs/main/docs/developer/checkout/overview.mdx