Vercel

Develop. Preview. Ship.

Join the Vercel Community

Usage

Vercel's frontend cloud gives developers frameworks, workflows, and infrastructure to build a faster, more personalized web.

To install the latest version of Vercel CLI, run this command:

``bash
npm i -g vercel
`

To quickly start a new project, run the following commands:

`bash
vercel init # Pick an example project
cd # Change directory to the new project
vercel # Deploy to the cloud
`

Finally, connect your Git repository to Vercel and deploy with git push.

Documentation

For details on how to use Vercel CLI, check out our documentation.

Local Development

To develop Vercel CLI, first check out the source code, install dependencies, and build all packages:

`bash
git clone https://github.com/vercel/vercel.git
cd vercel
pnpm install
pnpm build
`

At this point you can make modifications to the CLI source code and test them out locally. The CLI source code is located in the packages/cli directory.

`bash
cd packages/cli
`

$3

From within the packages/cli directory, you can use the "vercel" script to quickly execute Vercel CLI from its TypeScript source code directly (without having to manually compile first). For example:

`bash
pnpm vercel deploy
pnpm vercel whoami
pnpm vercel login
pnpm vercel switch --debug
`

When you are satisfied with your changes, make a commit and create a pull request!

$3

pnpm vercel executes a locally built dist. Because this dist lives locally in this monorepo,
the existence of node_modules can sometimes affect the behavior of how vercel CLI picking
up dependencies. To test the full user experience of downloading the CLI from the npm registry:

`bash


build the dist

monorepo_dir=$(pwd)
cd packages/cli && turbo build

use pnpm pack to create the same tarball that is uploaded to the npm registry

and store the tarball name in a variable

dist=$(pnpm pack)

In your test project

cd ~/dev/test-nextjs-proj

npx -p $monorepo_dir/packages/cli/$dist vercel build
``