create-sello-store

Scaffold a standalone Sello storefront (Vite + React + react-router) powered by @sellosh/commerce.

npx create-sello-store my-shop
cd my-shop
pnpm install          # or npm install
cp .env.example .env  # set VITE_BUSINESS_SLUG (e.g. shopdemo)
pnpm dev              # http://localhost:3001

You get a complete, guest-capable commerce front end — product list & detail, cart drawer, Buy Now, guest checkout (email + Korean address search), Toss payment, guest order lookup, reviews, social login, and post-purchase signup — all wired to the @sellosh/commerce SDK. Payments, stock, and customer data are handled safely server-side behind the SDK; you customize the design.

Env

• VITE_BUSINESS_SLUG — your shop slug (required). e.g. shopdemo.
• VITE_API_BASE_URL — empty to use the dev proxy to a local admin (:3000), or your admin URL (e.g. https://www.sello.sh) for production.

Verify it works

npx playwright install chromium
pnpm e2e   # guest purchase → Toss sandbox → paid order (needs a test-key shop)

The included e2e/guest-checkout.mjs drives a full guest purchase through the Toss sandbox — your "definition of done" when customizing.