# Colossal

> Developer documentation for Colossal. AI-native commerce infrastructure. Build storefronts, automate with agents, and deploy anywhere.

## Docs

- [Store Builder](https://docs.colossal.sh/agent-skills/colossal-builder.md): Generic Storefront SDK guide for any React app -- hooks, providers, types, and helpers.
- [Design Library](https://docs.colossal.sh/agent-skills/colossal-design-library.md)
- [Store Designer](https://docs.colossal.sh/agent-skills/colossal-store-design.md): Apply existing references from the Design Library to any project, or create new references from store screenshots. Drops in for shadcn projects; translates to Tailwind, vanilla CSS, Vue, or Svelte for everything else.
- [Overview](https://docs.colossal.sh/agent-skills/overview.md)
- [Actions catalog](https://docs.colossal.sh/agents/actions.md): Reference for all Colossal app actions available in the Agent Builder, including cart, checkout, customer, product, order, and HTTP operations.
- [Agent Library](https://docs.colossal.sh/agents/agent-library.md): Ready-made agents that merchants are using on Colossal today. Click a card to copy the prompt, then paste it into the dashboard.
- [Data access](https://docs.colossal.sh/agents/data-access.md): How to reference dynamic data in Agent Builder steps. Trigger payloads, app secrets, step outputs, and platform context.
- [Overview](https://docs.colossal.sh/agents/overview.md): Build commerce automation agents with natural language. Compose triggers and actions from any app.
- [AI reasoning](https://docs.colossal.sh/agents/step-types/ai-reasoning.md): AI reasoning step that sends prompts to an LLM with access to read and write tools, gated by per-tool approval.
- [App action](https://docs.colossal.sh/agents/step-types/app-action.md): App action step for executing operations from any installed app. Colossal built-in actions or third-party app actions like Stripe and Klaviyo.
- [Approval step](https://docs.colossal.sh/agents/step-types/approval.md): Approval step that pauses the workflow until a human approves or denies the run from the activity log.
- [Choice step](https://docs.colossal.sh/agents/step-types/choice.md): Choice step that evaluates conditions and routes execution to different branches, supporting if/then/else logic and nested rules.
- [Delay step](https://docs.colossal.sh/agents/step-types/delay.md): Delay step that pauses execution for a fixed duration in seconds, minutes, hours, or days before continuing to the next step.
- [Map step](https://docs.colossal.sh/agents/step-types/map.md): Map step that iterates over an array from trigger data or previous steps and executes a sequence of sub-steps for each element.
- [Parallel step](https://docs.colossal.sh/agents/step-types/parallel.md): Parallel step that executes multiple branches concurrently, waits for all to complete, then merges results before continuing.
- [Wait for event step](https://docs.colossal.sh/agents/step-types/wait-for-event.md): Wait-for-event step that pauses execution until a matching webhook or platform event arrives, with configurable timeout handling.
- [Event triggers](https://docs.colossal.sh/agents/triggers/event-triggers.md): Event triggers start agents when commerce events occur. Orders, cart updates, checkout, payments, and more.
- [Scheduled triggers](https://docs.colossal.sh/agents/triggers/scheduled-triggers.md): Configure scheduled triggers to run agents at recurring times using cron expressions or fixed intervals for reports, syncs, and cleanup.
- [App triggers](https://docs.colossal.sh/agents/triggers/webhook-triggers.md): Trigger agents when installed apps send webhook events. Sync products from Shopify, react to Stripe payments, and more.
- [Authentication](https://docs.colossal.sh/api-reference/authentication.md): Authenticate Storefront API requests with your storefront API key.
- [Cart](https://docs.colossal.sh/api-reference/cart.md): Create and manage shopping carts via the Storefront API.
- [Checkout](https://docs.colossal.sh/api-reference/checkout.md): Create and manage checkout sessions via the Storefront API.
- [Customers](https://docs.colossal.sh/api-reference/customers.md): Create customer records via the Storefront API.
- [Orders](https://docs.colossal.sh/api-reference/orders.md): Query order details and line items from the Storefront API.
- [Overview](https://docs.colossal.sh/api-reference/overview.md): The Storefront API. A public GraphQL endpoint for products, cart, checkout, and orders.
- [Products](https://docs.colossal.sh/api-reference/products.md): Query products, variants, pricing, media, and deliverables from the Storefront API.
- [Store](https://docs.colossal.sh/api-reference/store.md): Query store configuration, theming, and domain details from the Storefront API.
- [Overview](https://docs.colossal.sh/apps/colossal-app.md): Built-in triggers and actions available in every project. The foundation of the Agent Builder.
- [Actions](https://docs.colossal.sh/apps/colossal-app/actions.md): Built-in Colossal app actions with input and output schemas for each.
- [Tools](https://docs.colossal.sh/apps/colossal-app/tools.md): LLM-callable functions used by the AI Reasoning step and the chat agent. Reads fetch data. Writes mutate state and run through approval policy.
- [Trigger modes](https://docs.colossal.sh/apps/colossal-app/trigger-modes.md): How Colossal app triggers execute. Most events run async. Some run sync to modify state mid-action; others are request/response that return typed data.
- [Triggers](https://docs.colossal.sh/apps/colossal-app/triggers.md): Colossal app event triggers. Full list of events and their payload schemas.
- [Cart](https://docs.colossal.sh/concepts/cart.md)
- [Checkout and payments](https://docs.colossal.sh/concepts/checkout-and-payments.md)
- [Customers](https://docs.colossal.sh/concepts/customers.md)
- [Billing and invoices](https://docs.colossal.sh/concepts/invoices-and-billing.md): Billing plans, invoicing, metered usage, and subscription pricing.
- [Orders](https://docs.colossal.sh/concepts/orders.md)
- [Products](https://docs.colossal.sh/concepts/products.md)
- [Overview](https://docs.colossal.sh/concepts/projects.md)
- [Agentic commerce](https://docs.colossal.sh/deployment/agentic-commerce.md): Distribute your products through AI shopping agents. Coming soon.
- [Model Context Protocol (MCP)](https://docs.colossal.sh/developer-tools/mcp.md): Set up the Colossal MCP server to give AI coding assistants direct access to your store's products, customers, orders, and analytics via GraphQL.
- [Welcome to Colossal](https://docs.colossal.sh/index.md)
- [Model Context Protocol (MCP)](https://docs.colossal.sh/model-context-protocol.md): Connect your AI coding assistant directly to your Colossal store's GraphQL API via the MCP server.
- [Create a storefront](https://docs.colossal.sh/quickstart/create-a-storefront.md): Create a Colossal storefront with products and checkout in under 5 minutes.
- [Create an agent](https://docs.colossal.sh/quickstart/create-an-agent.md): Create your first commerce agent in a few minutes by describing it.
- [Cart](https://docs.colossal.sh/react-sdk/cart.md): Create and manage shopping carts with add, update, and remove operations.
- [Checkout](https://docs.colossal.sh/react-sdk/checkout.md): Create checkout sessions and redirect customers to the Colossal hosted checkout page for payment and order completion.
- [Full example](https://docs.colossal.sh/react-sdk/example.md): Build a complete storefront with product browsing, cart management, and checkout.
- [Overview](https://docs.colossal.sh/react-sdk/overview.md)
- [Products](https://docs.colossal.sh/react-sdk/products.md): Fetch and display store products with type-safe hooks.
- [Theming](https://docs.colossal.sh/react-sdk/theming.md): Customize your Colossal storefront appearance using project theme configuration, CSS variables, and server-side theme fetching with fetchStoreThemeConfig.

## OpenAPI Specs

- [openapi](https://docs.colossal.sh/api-reference/openapi.json)