---
title: Setup
description: Set up Shopify, create a project, and run Vercel Shop locally.
type: guide
---

# Setup



Connect a Shopify store and run Vercel Shop locally in a few minutes.

## 1. Get Shopify credentials

Install Shopify's **Headless** sales channel, create a storefront, and copy its **Storefront API access token**. Enable the required [Storefront API permissions](/docs/reference/storefront-api-permissions).

## 2. Create your project

```bash
npx create-vercel-shop@latest my-store
cd my-store
```

To deploy instead, use the Vercel flow:

<a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fshop%2Ftree%2Fmain%2Fapps%2Ftemplate&products=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22shopify%22%2C%22productSlug%22%3A%22shopify%22%2C%22protocol%22%3A%22other%22%7D%5D">
  <img src="https://vercel.com/button" alt="Deploy with Vercel" />
</a>

The deploy flow connects your Shopify store and configures the required credentials.

## 3. Add your credentials

Create `.env.local` in the project root:

```bash
NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN="your-store.myshopify.com"
NEXT_PUBLIC_SHOPIFY_STOREFRONT_ACCESS_TOKEN="shpat_1234567890abcdefghijklmnopqrstuvwxyz"
```

See [Environment Variables](/docs/reference/env-vars) for optional settings.

## 4. Run the storefront

```bash
npm run dev
```

Open [localhost:3000](http://localhost:3000) and confirm that your Shopify products appear.

For local HTTPS, install [Portless](https://portless.sh) with `npm install -g portless`, then run `npm run dev:portless`. Use HTTPS when testing OAuth callbacks or secure cookies.

## Next steps

<Cards>
  <Card title="Shopify Setup" href="/docs/getting-started/shopify-setup">
    Configure the Shopify apps and sales channel used by the storefront.
  </Card>

  <Card title="Extending with Agents" href="/docs/getting-started/extending-with-agents">
    Customize the storefront with coding agents and project skills.
  </Card>

  <Card title="Environment Variables" href="/docs/reference/env-vars">
    Configure authentication, the shopping assistant, and other optional features.
  </Card>
</Cards>


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)