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

# Vulpy Commerce: an AI-run shop in a box

> Vulpy Commerce is a self-hostable ecommerce product with the Fox AI operator built in: Medusa v2, Next.js and Payload storefront, self-hosted Matomo.

Vulpy Commerce is a self-hostable ecommerce product that ships with its own AI operator, Fox, inside the box. Fox is a Hermes agent container that boots your shop from a fresh install, runs it day to day, and grows with you through a guided missions system. Under the hood you get a Medusa v2 backend, a Next.js storefront with Payload CMS, and self-hosted Matomo analytics on live.

<Tip>
  **These docs exist, but Fox knows the ins and outs.** Every page here is a reference. The fastest way to get anything done is to open the Vulpy WebUI and ask Fox. Fox reads the same repo, runs the same commands, and can point you at (or fix) whatever you need.

  Try prompts like:

  * "Add a new product and put it in the summer category."
  * "Why is the storefront returning a 500 on /checkout?"
  * "Take me through going live on my domain."
</Tip>

## Explore the docs

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Clone the repo and get Fox and the storefront running locally in about ten minutes.
  </Card>

  <Card title="Architecture" icon="layer-group" href="/architecture">
    Fox, the storefront, Medusa, and Matomo: how the pieces fit together.
  </Card>

  <Card title="Meet Fox" icon="robot" href="/fox/overview">
    What the built-in AI operator is, what it does, and where you approve its actions.
  </Card>

  <Card title="Deploy to a VPS" icon="server" href="/deploy/production">
    The one-liner install for Ubuntu 24.04 with Docker, Caddy, and Tailscale.
  </Card>
</CardGroup>

## From zero to a live shop

<Steps>
  <Step title="Install locally">
    Run `pnpm bootstrap` to set up env files, install dependencies, start Postgres, migrate, seed, and create an admin user.
  </Step>

  <Step title="Start Fox">
    `pnpm db:hermes:up` brings up the Fox container. Open the Vulpy WebUI at [http://localhost:8787](http://localhost:8787).
  </Step>

  <Step title="Run onboarding missions">
    Complete the guided welcome flow. Fox brings up the storefront and Medusa, runs migrations, seeds the catalog, and verifies the shop is healthy.
  </Step>

  <Step title="Go live">
    On a VPS, add a live environment with `pnpm vulpy env add live`, then `pnpm vulpy env golive live` when Matomo is up and the preview host is ready to 301 to your apex.
  </Step>
</Steps>

<Note>
  This is the Pro edition of Vulpy Commerce. Core (free) ships the same store plus Fox; Pro adds Payload product and category editorial, server install, and B2B or quote workflows. See [editions](/reference/editions).
</Note>