# Developer guides

Choose the outcome you want to implement.
Each guide includes prerequisites, concrete steps, and a way to verify the result.
The [concept pages](/concepts) explain shared behavior so task guides can stay focused.

## Prepare a catalog

1. [Configure a store](/guides/catalog/configure-store) and connect its channels.
2. [Create and publish a product](/guides/catalog/create-product), using [price and stock setup](/guides/catalog/configure-commerce) for its commercial data.
3. [Organize the catalog](/guides/catalog/organize-catalog) with categories and collections.
4. [Translate content](/guides/catalog/translate-content) and [add typed custom data](/guides/catalog/custom-data) where needed.
5. [Place your first test order](/getting-started/first-order) to verify the complete path.

## Build a storefront

Start with the [Next.js reference storefront](/guides/storefront/nextjs) or the [Storefront API quickstart](/getting-started/storefront-quickstart).

| Feature | Guide |
| --- | --- |
| Catalog pages and variant selection | [Product listing and detail pages](/guides/storefront/product-pages) |
| Search state and pagination | [Search and filters](/guides/storefront/search-and-filters) |
| Configured filter controls | [Facets](/guides/storefront/facets) |
| Responsive media | [Product images](/guides/storefront/images) |
| Hosted or custom purchase flow | [Cart and checkout](/guides/storefront/cart-and-checkout) |
| Registration and sessions | [Customer accounts](/guides/storefront/customer-accounts) |
| Buyer-facing failure recovery | [Storefront errors](/guides/storefront/error-recovery) |

## Extend the dashboard or connect a system

[Build an embedded app](/guides/apps/getting-started), understand its [authentication and sessions](/guides/apps/authentication), then [add a protected page](/guides/apps/protected-page).
For external systems, use [catalog synchronization](/guides/integrations/catalog-sync), [bulk operations and jobs](/guides/integrations/bulk-and-jobs), and [verified webhooks](/guides/integrations/webhooks).

## Run commerce operations

Use [Analytics queries](/guides/operations/analytics) to report sales, compare periods, and group results by product, store, payment method, or discount.

Use [Discount campaigns](/guides/operations/discount-campaign), [Draft orders](/guides/operations/draft-order), [Fulfillment](/guides/operations/fulfill-order), and [Payment actions](/guides/operations/manage-payments) for operational tasks.
Each action needs the appropriate Admin access and current resource state.

## Work with a coding agent

[Build with an AI agent](/guides/ai-agents) explains how to supply context, use Markdown sources, and distinguish schema validation from a verified project outcome.