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

# Setup



Vercel Shop needs a Shopify storefront token and three environment variables. You can scaffold it locally or deploy it directly to Vercel.

## Connect Shopify

Install Shopify's **Headless** sales channel, create a storefront, and copy its **Storefront API access token**. Enable the permissions used by the template; see [Storefront API Permissions](/docs/reference/storefront-api-permissions) for the exact scopes.

## Create your project

Scaffold a local project:

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

Or deploy the template directly to Vercel:

<a href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fshop%2Ftree%2Fmain%2Fapps%2Ftemplate&env=SHOPIFY_STOREFRONT_ACCESS_TOKEN,SHOPIFY_STORE_DOMAIN,NEXT_PUBLIC_SITE_NAME&envDescription=Required%20values%20to%20work%20with%20Shopify&envLink=https%3A%2F%2Fvercel.shop%2Fdocs%2Freference%2Fenv-vars&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>

## Add your credentials

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

```bash
SHOPIFY_STORE_DOMAIN="your-store.myshopify.com"
SHOPIFY_STOREFRONT_ACCESS_TOKEN="[redacted]"
NEXT_PUBLIC_SITE_NAME="Your Store Name"
```

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

## Run locally

Start the development server with your package manager:

```bash
npm run dev
```

Open [localhost:3000](http://localhost:3000).

> **Local HTTPS:** Install [Portless](https://portless.sh) with `npm install -g portless`, then run `npm run dev:portless` to serve the storefront at [shop.localhost](https://shop.localhost). This is useful for testing OAuth callbacks and 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)