---
name: vercel-deploy
description: Deploy applications and websites to Vercel with a claimable preview. Use when the user requests deployment actions like "deploy my app", "deploy and give me…
---

# vercel-deploy

Deploy applications and websites to Vercel with a claimable preview. Use when the user requests deployment actions like "deploy my app", "deploy and give me…

# vercel-deployby vercel
Deploy applications and websites to Vercel with a claimable preview. Use when the user requests deployment actions like "deploy my app", "deploy and give me…

`npx skills add https://github.com/vercel-labs/vercel-deploy-codex-skill --skill vercel-deploy`Download ZIPGitHub

## Vercel Deploy

Deploy any project to Vercel instantly. No authentication required.

## How It Works

* Packages your project into a `.tar.gz` (excludes `node_modules` and `.git`)

* Auto-detects framework from `package.json`

* Uploads to deployment service

* Returns Preview URL (live site) and Claim URL (transfer to your Vercel account)

## Usage

```
`bash scripts/deploy.sh [path]
`
```

Arguments:

* `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)

If you pass a directory, the script will create a `.tar.gz` before upload.

Examples:

```
`# Deploy current directory
bash scripts/deploy.sh

# Deploy specific project
bash scripts/deploy.sh /path/to/project

# Deploy existing tarball
bash scripts/deploy.sh /path/to/project.tgz
`
```

## Packaging Rules

* Exclude `node_modules` and `.git`

* If no `package.json`, keep `framework` as `null`

* For static HTML with a single `.html` file, rename it to `index.html` before packaging

## Output

```
`Preparing deployment...
Creating deployment package...
Deploying...
✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app
Claim URL: https://vercel.com/claim-deployment?code=...
`
```

The script also outputs JSON to stdout for programmatic use.

```
`{
"previewUrl": "https://skill-deploy-abc123.vercel.app",
"claimUrl": "https://vercel.com/claim-deployment?code=...",
"deploymentId": "dpl_...",
"projectId": "prj_..."
}
`
```

## Framework Detection

The script auto-detects frameworks from `package.json`. Supported frameworks include:

* React: Next.js, Gatsby, Create React App, Remix, React Router

* Vue: Nuxt, Vitepress, Vuepress, Gridsome

* Svelte: SvelteKit, Svelte, Sapper

* Other Frontend: Astro, Solid Start, Angular, Ember, Preact, Docusaurus

* Backend: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro

* Build Tools: Vite, Parcel

* And more: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.

For static HTML projects (no `package.json`), framework is set to `null`.

## Static HTML Projects

For projects without a `package.json`:

* If there's a single `.html` file not named `index.html`, it gets renamed automatically

* This ensures the page is served at the root URL (`/`)

## Present Results to User

Always show both URLs:

```
`✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app
Claim URL: https://vercel.com/claim-deployment?code=...

View your site at the Preview URL.
To transfer this deployment to your Vercel account, visit the Claim URL.
`
```

## Troubleshooting

### Network Egress Error

If deployment fails due to network restrictions, tell the user:

```
`Deployment failed due to network restrictions. To fix this:

1. Allow outbound access to *.vercel.com
2. Try deploying again
`
```

## More skills from vercel
agent-friendly-apisby vercelCompanion skill for the Agent-Friendly APIs course on Vercel Academy. Build a feedback API, make it agent-friendly with structured documentation, then create a Claude Code skill that generates the docs automatically.filesystem-agentsby vercelYou are a knowledgeable teaching assistant for the Building Filesystem Agents course on Vercel Academy. You help students build agents that navigate filesystems with bash to answer questions about structured data.add-provider-packageby vercelGuide for adding new AI provider packages to the AI SDK. Use when creating a new @ai-sdk/<provider> package to integrate an AI service into the SDK.csvby vercelAnalyze and transform CSV data using bash toolsaiby vercelPython `ai` module — models, agents, hooks, middleware, MCP, structured outputcron-jobsby vercelVercel Cron Jobs configuration and best practices. Use when adding, editing, or debugging scheduled tasks in vercel.json.frontend-designby vercelCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts,…vercel-react-best-practicesby vercelReact and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js…

---

**Source**: https://github.com/vercel-labs/vercel-deploy-codex-skill/tree/HEAD/skills/vercel-deploy
**Author**: vercel
**Discovered via**: mcpservers.org