Integracao Vercel

Conecte sua conta Vercel ao BuildShip pra publicar seus projetos automaticamente em produzao, com preview por branch, SSL e dominios customizados.

Em breve: a integracao via OAuth esta sendo finalizada. Por enquanto, voce pode conectar colando um Access Token manualmente — veja abaixo.

O que da pra fazer

Deploy de producao a cada push no branch principal
Preview deployments por branch/PR
SSL automatico via Let's Encrypt
Dominios customizados (conecta com Cloudflare)
Variaveis de ambiente configuradas automaticamente
Edge network global
Suporte para Next.js, SvelteKit, Nuxt, Astro, Remix e muitos outros

Como conectar (jeito manual, por enquanto)

Acesse vercel.com/account/tokens
Clique em "Create Token"
De um nome: "BuildShip"
Escopo: escolha "Full Account" ou um team especifico
Expiracao: recomendado "No Expiration" (voce pode revogar depois)
Clique Create e copie o token (so aparece uma vez)
No BuildShip, abra qualquer projeto, clique em Integracoes na barra lateral do chat
Clique em Vercel e cole o token no campo "Access Token"
Opcionalmente, cole o Team ID se seus projetos estao num team (pegue em vercel.com/dashboard > seu team > Settings > General > Team ID)
Clique Ativar

Como conectar (em breve: OAuth)

A versao final vai funcionar igual Supabase e GitHub: 1 clique em "Conectar com Vercel", autoriza no marketplace do Vercel, volta pro BuildShip, escolhe o projeto e pronto. Acompanhe as atualizacoes em integracoes.

Primeiro deploy

Depois que a integracao estiver ativa, voce pode pedir ao time pra fazer o deploy pelo chat:

"Publica essa versao em producao"

O time vai verificar que tudo compila, configurar as variaveis de ambiente necessarias (por exemplo, as credenciais do Supabase se voce tiver essa integracao ativa), fazer o deploy e te mandar o link final.

Dominio customizado

Se voce tem um dominio proprio (ex: meusite.com):

Conecte a integracao Cloudflare no BuildShip (se o dominio estiver la)
Peca ao time: "Configura o dominio meusite.com nesse projeto"
O time adiciona o dominio na Vercel, configura os registros DNS no Cloudflare e aguarda a propagacao
Em ~5 minutos o site esta acessivel pelo seu dominio com SSL

Variaveis de ambiente

Variaveis de ambiente sao configuradas automaticamente quando outras integracoes estao ativas no projeto. Por exemplo, se voce conectou Supabase, o time vai copiar:

PUBLIC_SUPABASE_URL
PUBLIC_SUPABASE_ANON_KEY
SUPABASE_SERVICE_ROLE_KEY (server-side, criptografada)

Voce tambem pode pedir pro time adicionar variaveis manuais: "Cria uma variavel STRIPE_SECRET_KEY no Vercel com o valor sk_test_xxx".

Problemas comuns

Erro "Invalid token"

O token que voce colou foi revogado ou nao existe. Gere um novo em vercel.com/account/tokens e tente de novo.

Build falha na Vercel

Geralmente e porque alguma dependencia falta no package.json, ou a versao do Node esta errada. Voce pode pedir ao time: "o build ta falhando na Vercel com o erro X" e colar o erro — o code reviewer vai identificar e corrigir.

Deploy ficou em "Building" por muito tempo

Vercel tem timeout de 45 minutos no plano gratuito, 6 horas no Pro. Se o build esta demorando demais, e provavel que tenha entrado em loop ou esta tentando baixar algo muito grande. Cancele o deploy no dashboard da Vercel e peca ao time pra investigar.