# init-vercel-shop

Sets up a new Vercel Shop storefront from the vercel/shop template in a folder you choose, using create-next-app.

Skill by Vercel. Category: Web and browsers.

## Install

Project (for this project only):

```sh
npx skills add vercel/shop --skill init-vercel-shop
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add vercel/shop --skill init-vercel-shop -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 18. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/site/vercel.shop/init-vercel-shop)

## Source

[Open the source](https://github.com/vercel/shop/tree/HEAD/.agents/skills/init-vercel-shop). Checked 2026-10-24. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: init-vercel-shop
description: Initialize a new Vercel Shop storefront from the vercel/shop template with create-next-app. Use when the user wants to create, scaffold, start, or initialize a Vercel Shop project from a coding agent.
---

# Initialize Vercel Shop

Ask for the target directory if the user did not provide one. Always pass it explicitly.

1. Inspect the target. If it already contains a Vercel Shop project, stop and use the relevant storefront skill instead. If it is a non-empty directory, ask for a different target rather than overwriting files.
2. Run:

   ```bash
   pnpm create next-app@latest <target-directory> --example https://github.com/vercel/shop
   ```

   The template pins pnpm 12 and Node.js 24.

3. Confirm the generated project contains `AGENTS.md`, `.agents/skills/`, `app/`, `components/`, `lib/shopify/`, and `package.json`.
4. Read the generated `AGENTS.md` before making further changes.
5. If dependency installation fails, keep the generated project and show the retry command to run from its root:

   ```bash
   pnpm install
   ```

6. Ask one optional follow-up: **Connect an existing Shopify store now?**

   If yes, ask only for the store's admin URL or `.myshopify.com` domain, then read [references/storefront-token.md](references/storefront-token.md) and follow its automated Shopify CLI flow. Try to reuse or create a public Storefront token before asking the user to visit the Headless channel.

   If no, finish with the normal environment setup as the next step.

Return the generated project path, whether a Shopify store was connected, and whether dependency installation needs a retry.
````

- Previous: [build-shop](https://syn4pse.dev/terminal/build-shop.md)
- Next: [update-shop](https://syn4pse.dev/terminal/update-shop.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
