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:Verify installation
Authenticate
Run your first command
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.Google Cloud Platform
Deploy on GCP Compute Engine for ~$5-12/month with automatic restarts and SSH tunnel access.
Hetzner
The most cost-effective option at ~$5/month on Hetzner VPS with Docker and persistent volumes.
Fly.io
Deploy globally with automatic HTTPS and edge distribution for ~$10-15/month.
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: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:Orders Quickstart
Create, update, and fulfill orders programmatically.
Returns Quickstart
Process returns and refunds with the Returns API.