> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iCommerce Quickstart

> Get started with StateSet iCommerce using the CLI or deploy to your preferred cloud platform.

# iCommerce Quickstart

Get up and running with StateSet iCommerce in minutes. Install the CLI locally or deploy to your preferred cloud platform.

## Install the CLI

Install the StateSet CLI globally using npm:

```bash theme={null}
npm install -g @stateset/cli
```

Or use npx to run without installing:

```bash theme={null}
npx @stateset/cli
```

### Verify installation

```bash theme={null}
stateset --version
```

### Authenticate

```bash theme={null}
stateset auth login
```

### Run your first command

```bash theme={null}
stateset "show me pending orders"
```

<Tip>
  Use `--apply` flag to execute write operations. Without it, commands run in read-only mode for safety.
</Tip>

```bash theme={null}
stateset --apply "ship order #12345 with tracking FEDEX123"
```

***

## Deploy to the cloud

Run StateSet iCommerce 24/7 on your preferred cloud platform. Each guide walks you through a complete production deployment with persistent storage and secure access.

<CardGroup cols={3}>
  <Card title="Google Cloud Platform" icon="google" href="/stateset-icommerce/stateset-icommerce-gcp">
    Deploy on GCP Compute Engine for \~\$5-12/month with automatic restarts and SSH tunnel access.
  </Card>

  <Card title="Hetzner" icon="server" href="/stateset-icommerce/stateset-icommerce-hetzner">
    The most cost-effective option at \~\$5/month on Hetzner VPS with Docker and persistent volumes.
  </Card>

  <Card title="Fly.io" icon="paper-plane" href="/stateset-icommerce/stateset-icommerce-flyio">
    Deploy globally with automatic HTTPS and edge distribution for \~\$10-15/month.
  </Card>
</CardGroup>

***

## Prerequisites

Before you begin, ensure you have:

* StateSet account and API key
* Node.js 18+ installed
* Model provider credentials (Anthropic, OpenAI, etc.)

***

## Understand iCommerce

Review the category overview and architecture to understand the core model:

* [iCommerce Overview](/icommerce)
* [iCommerce Architecture](/icommerce-architecture)

***

## Choose your build track

Pick the track that matches your use case:

| Track                   | Description                          | Best for             |
| ----------------------- | ------------------------------------ | -------------------- |
| **StateSet One**        | Core API and platform services       | Backend integrations |
| **StateSet ResponseCX** | AI-driven customer operations        | Support automation   |
| **Agentic Commerce**    | Conversational checkout and payments | Chat-based sales     |

***

## Run a basic workflow

Follow a quickstart guide to run a basic order or return flow:

<CardGroup cols={2}>
  <Card title="Orders Quickstart" icon="box" href="/guides/orders-quickstart">
    Create, update, and fulfill orders programmatically.
  </Card>

  <Card title="Returns Quickstart" icon="rotate-left" href="/guides/returns-quickstart">
    Process returns and refunds with the Returns API.
  </Card>
</CardGroup>

***

## Next steps

<CardGroup cols={3}>
  <Card title="SDK Installation" icon="download" href="/guides/sdk-installation">
    Install SDKs for Node.js, Python, and more.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/stateset-icommerce/stateset-icommerce-cli-reference">
    Full CLI command reference and workflows.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/stateset-icommerce/stateset-icommerce-skills">
    Extend agent capabilities with custom skills.
  </Card>
</CardGroup>