Skip to main content

​
Scaffold the project

npm create colossal-project my-store
cd my-store
npm run dev
  1. Run the create command. You’ll be redirected to authenticate with Colossal.
  2. Choose an existing project or create a new one. New projects can be seeded with demo products.
  3. The starter template is cloned, dependencies are installed, and your .env is configured.
  4. Visit http://localhost:3000 to see your storefront.
Argument / flagDescription
[directory]Directory to create the project in. Prompts for a name if omitted.
--store-uid <uid>Store UID to use. Skips authentication and store selection.
--skip-installSkip running the install step after scaffolding.
--api-url <url>Override the Colossal API URL.
Pass --store-uid to bypass authentication and store selection in CI or automated environments:
pnpm create colossal-project my-store --store-uid your-uid

​
Install agent skills

Add the agent skills so your AI coding agent knows the SDK, the design library, and how to apply a reference: 
npx skills add colossalhq/agent-skills --all -a claude-code -a cursor -y

​
Generate the design

Ask your agent to build the store.

Create a beautiful store for my rap-inspired streetwear brand

Open in Cursor
The agent picks a reference from the Design Library, applies the theme into your project, and designs you a storefront using best practices and components from our design library.

​
Example

A live storefront built with this flow:

​
Store deployment

You can also build your storefront using Builder Agent and launch it on Colossal Cloud. Alternatively, you can build your own storefront using the Storefront SDK (we provide a convenient starter template) and self-host it using the hosting provider of your choice (Vercel, Cloudflare, or any other). In both cases you can leverage agentic commerce, letting customers discover and buy through AI chat apps.

​
Next steps

Storefront SDK

Hooks for products, cart, and checkout.

Deploy

Ship to Colossal Cloud or self-host anywhere.

Create an agent

Automate orders, notifications, and reports.

Apps

Connect Stripe, Klaviyo, Slack, and more.