Deploy para Vercel

Faça o deploy de qualquer projeto para o Vercel. Sempre faça o deploy como prévia (não produção) a menos que o usuário peça explicitamente por produção.

O objetivo é colocar o usuário na melhor configuração de longo prazo: o projeto dele vinculado ao Vercel com deploys via git-push. Cada método abaixo tenta aproximar o usuário desse estado.

Quando Usar

• Use esta habilidade quando a tarefa corresponder a esta descrição: Fazer o deploy de aplicações e websites para o Vercel. Use quando o usuário solicitar ações de deploy como "deploy meu app", "deploy e me dê o link", "coloque isso no ar" ou "crie um deploy de prévia".

Passo 1: Coletar o Estado do Projeto

Execute todas as quatro verificações antes de decidir qual método usar:

# 1. Check for a git remote
git remote get-url origin 2>/dev/null

# 2. Check if locally linked to a Vercel project (either file means linked)
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null

# 3. Check if the Vercel CLI is installed and authenticated
vercel whoami 2>/dev/null

# 4. List available teams (if authenticated)
vercel teams list --format json 2>/dev/null

Seleção de equipe

Se o usuário pertencer a várias equipes, apresente todos os slugs de equipe disponíveis como uma lista com marcadores e pergunte para qual delas fazer o deploy. Assim que o usuário escolher uma equipe, prossiga imediatamente para o próximo passo — não peça confirmação adicional.

Passe o slug da equipe via --scope em todos os comandos CLI subsequentes (vercel deploy, vercel link, vercel inspect, etc.):

vercel deploy [path] -y --no-wait --scope <team-slug>

Se o projeto já estiver vinculado (.vercel/project.json ou .vercel/repo.json existir), o orgId nesses arquivos determina a equipe — não é necessário perguntar novamente. Se houver apenas uma equipe (ou apenas uma conta pessoal), pule a solicitação e use-a diretamente.

Sobre o diretório .vercel/: Um projeto vinculado tem um dos seguintes:

• .vercel/project.json — criado por vercel link (vinculação de projeto único). Contém projectId e orgId.
• .vercel/repo.json — criado por vercel link --repo (vinculação baseada em repositório). Contém orgId, remoteName e um array projects mapeando diretórios para IDs de projeto Vercel.

Qualquer um dos arquivos significa que o projeto está vinculado. Verifique ambos.

NÃO use vercel project inspect, vercel ls ou vercel link para detectar o estado em um diretório não vinculado — sem uma configuração .vercel/, eles solicitarão interativamente (ou com --yes, vincularão silenciosamente como um efeito colateral). Apenas vercel whoami é seguro para executar em qualquer lugar.

Passo 2: Escolher um Método de Deploy

Vinculado (.vercel/ existe) + tem remote git → Git Push

Este é o estado ideal. O projeto está vinculado e tem integração git.

1. Pergunte ao usuário antes de fazer o push. Nunca faça push sem aprovação explícita:

   This project is connected to Vercel via git. I can commit and push to
   trigger a deployment. Want me to proceed?
   

2. Faça o commit e o push:

   git add .
   git commit -m "deploy: <description of changes>"
   git push
   

   O Vercel constrói automaticamente a partir do push. Branches que não são de produção recebem deploys de prévia; o branch de produção (geralmente main) recebe um deploy de produção.

3. Recupere a URL de prévia. Se o CLI estiver autenticado:

   sleep 5
   vercel ls --format json
   

   A saída JSON tem um array deployments. Encontre a entrada mais recente — o campo url dela é a URL de prévia.

   Se o CLI não estiver autenticado, diga ao usuário para verificar o painel do Vercel ou as verificações de status do commit no provedor git dele para a URL de prévia.

Vinculado (.vercel/ existe) + sem remote git → vercel deploy

O projeto está vinculado, mas não há repositório git. Faça o deploy diretamente com o CLI.

vercel deploy [path] -y --no-wait

Use --no-wait para que o CLI retorne imediatamente com a URL de deploy em vez de bloquear até que a construção termine (as construções podem demorar). Em seguida, verifique o status do deploy com:

vercel inspect <deployment-url>

Para deploys de produção (apenas se o usuário pedir explicitamente):

vercel deploy [path] --prod -y --no-wait

Não vinculado + CLI autenticado → Vincular primeiro, depois fazer deploy

O CLI está funcionando, mas o projeto ainda não está vinculado. Esta é a oportunidade de colocar o usuário no melhor estado.

1. Pergunte ao usuário para qual equipe fazer o deploy. Apresente os slugs de equipe do Passo 1 como uma lista com marcadores. Se houver apenas uma equipe (ou apenas uma conta pessoal), pule esta etapa.

…