---
title: Setup Environment
description: Set up Shopify, create a project, and run or deploy Vercel Shop.
url: "https://shop-docs.labs.vercel.dev/docs/getting-started"
docs_index: /llms.txt
lastUpdated: 2026-10-03
type: guide
---

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

Connect a Shopify store, then run Vercel Shop locally or deploy it to Vercel.

## Prerequisites

- Node.js 24
- [pnpm](https://pnpm.io) for installing dependencies and running scripts
- A Shopify store

## 1. Configure Shopify store

Install Shopify's [Headless sales channel](https://apps.shopify.com/headless), create a new storefront in the Headless channel app in your Shopify admin, and copy its **Storefront API access token**. Grant the required [Storefront API permissions](/docs/reference/storefront-api-permissions). For the full walkthrough, see [Setup Shopify](/docs/getting-started/shopify-setup).

> **Stores from the Vercel Marketplace:**
>
> If you created your store through the [Vercel Marketplace Shopify
> integration](https://vercel.com/marketplace/shopify), you have the **Vercel Storefronts** channel
> instead of **Headless**. Manage the storefront and its access token there.

## 2. Create your project

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

## 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"
NEXT_PUBLIC_SHOPIFY_SHOP_ID="123456789"
```

Find `NEXT_PUBLIC_SHOPIFY_STORE_DOMAIN` under [Settings → Domains](https://help.shopify.com/en/manual/domains) in Shopify admin. Find `NEXT_PUBLIC_SHOPIFY_STOREFRONT_ACCESS_TOKEN` in the [Headless channel storefront](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/manage-headless-channels). The shop ID is the number in your store's customer accounts URL, `https://shopify.com/123456789/account`.

> **Customer login needs more setup:**
>
> Customer accounts require additional credentials and configuration. See
> [Authentication](/docs/anatomy/authentication) before enabling sign-in.

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

## 4. Run the storefront

```bash
pnpm dev
```

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

If no products appear, you may still need to publish products to the Headless channel. See [publishing products to your storefront](/docs/getting-started/shopify-setup#publish-products-to-your-storefront).

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

## 5. Deploy to Vercel

When you're ready to deploy, commit and push your changes to your Git repository. Then import the project at [vercel.com/new](https://vercel.com/new), or use the CLI:

```bash
pnpm add -g vercel
vercel
```

Add the required [environment variables](/docs/reference/env-vars) to the Vercel project before your first production deploy. Stores created through the [Vercel Marketplace Shopify integration](https://vercel.com/marketplace/shopify) have their Shopify credentials configured for you.

## Related links

#### [Setup Shopify](/docs/getting-started/shopify-setup)

Configure the Shopify apps and sales channel used by the storefront.

#### [Extending with Agents](/docs/getting-started/extending-with-agents)

Customize the storefront with coding agents and project skills.

#### [Environment Variables](/docs/reference/env-vars)

Configure authentication, the shopping assistant, and other optional features.

---

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)