> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vulpy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Tip>
  **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."
</Tip>

## Prerequisites

## Prerequisites

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

## Get running

<Steps>
  <Step title="Clone the repo">
    ```bash theme={null}
    git clone https://github.com/vulpy-io/vulpy-commerce-pro
    cd vulpy-commerce-pro
    ```
  </Step>

  <Step title="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.

    ```bash theme={null}
    pnpm bootstrap
    ```
  </Step>

  <Step title="Start storefront and Medusa">
    `pnpm dev` starts Postgres, runs the storefront and the Medusa backend on the host, and stops Postgres on exit.

    ```bash theme={null}
    pnpm dev
    ```
  </Step>

  <Step title="Start Fox">
    In a second terminal, bring up the Hermes container. Fox exposes the Vulpy WebUI on port 8787.

    ```bash theme={null}
    pnpm db:hermes:up
    ```
  </Step>
</Steps>

## Where to open what

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

Sign in to the Medusa admin with the seeded credentials: `admin@example.com` / `supersecret`. Rotate them anytime with `pnpm vulpy user reset`.

<Tip>
  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.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Run onboarding missions" icon="robot" href="/fox/missions">
    Let Fox guide first-boot setup through the welcome flow.
  </Card>

  <Card title="Manage your catalog" icon="tags" href="/shop/catalog">
    Create products and add editorial content in Payload.
  </Card>
</CardGroup>