Quickstart: your first Vulpy Commerce shop

Clone Vulpy Commerce, run pnpm bootstrap, start the storefront and Medusa, then bring up Fox in the Vulpy WebUI, all in about ten minutes.

This quickstart takes you from a fresh clone to Fox running in the Vulpy WebUI, with the storefront and Medusa admin reachable locally. Everything runs on your machine via Docker Compose and the host Node processes.

The fastest path is to ask Fox. Fox can bootstrap and start the entire stack for you from the Vulpy WebUI.

• “Bootstrap the shop for me.”
• “Start the storefront and Medusa.”
• “Open the WebUI and walk me through the welcome flow.”

Prerequisites

Prerequisites

• Node.js 20 or newer
• pnpm 9 or newer
• Docker with the Compose plugin

Get running

1. Clone the repo

   git clone https://github.com/vulpy-io/vulpy-commerce-pro
   cd vulpy-commerce-pro
   
2. Bootstrap the shop

   pnpm bootstrap writes env files, installs dependencies, starts Postgres, runs Medusa migrations, seeds the catalog, creates an admin user, and syncs the publishable key.

   pnpm bootstrap
   
3. Start storefront and Medusa

   pnpm dev starts Postgres, runs the storefront and the Medusa backend on the host, and stops Postgres on exit.

   pnpm dev
   
4. Start Fox

   In a second terminal, bring up the Hermes container. Fox exposes the Vulpy WebUI on port 8787.

   pnpm db:hermes:up
   

Where to open what

Service	URL
Vulpy WebUI (Fox)	http://localhost:8787
Storefront	http://localhost:3000
Payload admin	http://localhost:3000/admin
Medusa API	http://localhost:9000
Medusa admin	http://localhost:9000/app

Sign in to the Medusa admin with the seeded credentials: [e-mail] / supersecret. Rotate them anytime with pnpm vulpy user reset.

Prefer the raw stack? pnpm dev runs storefront and Medusa without Fox. The product experience is the agent, though, so give Fox a try in the WebUI.

Next steps

Run onboarding missions

Let Fox guide first-boot setup through the welcome flow.

Manage your catalog

Create products and add editorial content in Payload.