StateSet Demo App

Demo application showcasing StateSet platform workflows, agent interactions, and commerce integrations.

The StateSet Demo App is a reference application that demonstrates core platform capabilities — order management, return processing, AI agent interactions, and third-party integrations — in a working frontend.

What’s Included

• Order workflows — Create, fulfill, ship, and manage orders through the full lifecycle.
• Return processing — Initiate returns, generate RMAs, and process refunds.
• AI agent interaction — Chat with a StateSet Response agent that retrieves live commerce data.
• Inventory management — View stock levels, adjust quantities, and transfer between locations.
• Integration demos — Working examples of Shopify, Stripe, and Gorgias integrations.

Run Locally

Prerequisites

• Node.js v18+
• A StateSet API key

Setup

git clone https://github.com/stateset/stateset-demo-app.git
cd stateset-demo-app
npm install

Configure Environment

STATESET_API_KEY=your_api_key
NEXT_PUBLIC_APP_URL=http://localhost:3000

Start the App

npm start

Open http://localhost:3000.

Demo Scenarios

Scenario	Description
Order-to-cash	Create an order, capture payment, fulfill, and ship
Return flow	Customer-initiated return through inspection and refund
Agent chat	Ask the AI agent about order status, return policies, or inventory
Inventory sync	Update stock across multiple warehouse locations

Architecture

Demo App (Next.js)
    │
    ├── Stateset One API (orders, returns, inventory)
    ├── Stateset Response API (AI agents)
    ├── Shopify (product data)
    └── Stripe (payments)

The demo app ships with seeded data and permissive defaults so it runs with no setup. That makes it a good way to see the platform work and a bad starting point for production — the API hardening defaults that a real deployment enforces are relaxed here on purpose. Read API hardening before reusing any of its configuration.

Related Documentation

• Demo App README
• API Reference
• Orders Quickstart
• Response Quickstart