[ajuda] conexões

Vercel do zero: conta, plano, publicar pelo GitHub, domínio e token

Crie a conta em vercel.com/signup entrando com o GitHub. Para site de negócio, o plano é o Pro: o Hobby, grátis, é só para uso pessoal. Publique pelo GitHub em vercel.com/new (cada envio atualiza o site) ou peça ao AFK. O token, criado em vercel.com/account/settings/tokens, vai na Central de Conexões, no cartão Vercel.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Pôr no ar o site, a landing de venda ou o app que o AFK criou, com endereço .vercel.app ou o seu domínio, e cadeado HTTPS.
Publicar sozinho a cada envio: com o repositório do GitHub ligado, cada "salva no github" vira uma nova versão no ar.
Desfazer em um clique: toda publicação fica guardada, e dá para voltar para a anterior.

Para uma página simples por link (proposta, orçamento, cardápio), a Cloudflare grátis já resolve: veja Mandar proposta, orçamento ou página por link (e usar o seu domínio).

Antes: Hobby ou Pro

	Hobby	Pro
Preço	Grátis	US$ 20 por pessoa que publica, por mês (quem só vê não paga)
Uso permitido	Só pessoal, sem fins comerciais	Negócio, loja, landing de venda
Para quem	Portfólio, teste, projeto de estudo	Site da empresa e tudo que vende

O uso comercial no Hobby vai contra as regras da Vercel, e o projeto pode ser pausado. Dá para começar com o teste grátis do Pro. O preço pode mudar: confira em vercel.com/pricing.

Parte 1: criar a conta

O site da Vercel é em inglês. Os nomes dos botões abaixo estão como aparecem na tela.

Faça antes o GitHub: veja GitHub do zero: conta, 2FA, repositório privado, login e token. A Vercel publica a partir dele.
Abra vercel.com/signup e escolha Continue with GitHub. Assim a Vercel já enxerga os seus repositórios.
Escolha o plano: Hobby para uso pessoal ou Pro para negócio (veja a tabela acima).
Ligue a verificação em duas etapas: abra vercel.com/account/settings/authentication, ligue a chave de Two-Factor Authentication, escolha Authenticator App (o mesmo app do GitHub), digite o código de 6 números e guarde os códigos de recuperação fora do computador.

Parte 2: publicar o primeiro site pelo GitHub

Abra vercel.com/new.
Em Import Git Repository, clique em Import ao lado do repositório do site. Se ele não aparecer, use o link embaixo da lista para dar ao app da Vercel no GitHub acesso a esse repositório.
A Vercel reconhece o tipo de site sozinha. Se o site usa chaves (banco, pagamento), abra Environment Variables e cadastre cada uma ali, nunca no código.
Clique em Deploy. Em um ou dois minutos aparece o endereço nome-do-projeto.vercel.app.

A partir daí, é automático. Cada envio para o ramo principal (main) publica o site. Envio para outro ramo gera uma prévia com endereço próprio, para testar antes, sem mexer no site no ar.

Parte 3: pôr o seu domínio

No projeto, abra Settings → Domains, digite o seu domínio (por exemplo minhaempresa.com.br) e clique em Add.
A Vercel mostra os registros que o domínio precisa (tipo, nome e valor). Copie exatamente o que aparecer na tela: os valores mudam de projeto para projeto.
Cadastre esses registros onde o seu domínio aponta:
- Domínio na Cloudflare: painel da Cloudflare → o domínio → DNS → Add record. Para o registro do site, deixe a nuvem cinza (DNS only), senão o cadeado da Vercel não sai.
- Domínio só no Registro.br: registro.br → o domínio → Editar zona (ou DNS).
Volte à Vercel e espere o aviso Invalid Configuration sumir do domínio. Leva de minutos a algumas horas. O cadeado HTTPS sai sozinho logo depois.

Parte 4: publicar pelo terminal (o que o AFK usa)

O AFK publica com a CLI oficial da Vercel. Você não precisa decorar nada. Para conferir ou fazer na mão:

Instale (precisa do Node.js 18 ou mais novo; se não tiver: winget install OpenJS.NodeJS.LTS):
```
npm i -g vercel
```
Entre: vercel login. Abre o navegador para confirmar a conta.
Na pasta do site: vercel publica uma prévia. vercel --prod publica no ar. Na primeira vez, ele pergunta o time e o nome do projeto e liga a pasta ao projeto.
Chaves do site: vercel env add NOME production cadastra; vercel env pull baixa para testar no PC.

Parte 5: criar o token e colar no AFK

O token deixa o AFK publicar sem você logar no terminal, inclusive pela VPS.

Abra vercel.com/account/settings/tokens. No topo da página fica o quadro Create Token.
Quadro Create Token da Vercel com os campos Token name, Scope e Expiration e o botão Create
Preencha:
- TOKEN NAME: afk.
- SCOPE: escolha o seu time, o primeiro da lista, com o seu nome. Evite Full Account: ele dá acesso a todos os times da conta.
- EXPIRATION: escolha 1 Year. O token que nunca vence fica mais perigoso se vazar.
Lista de escopo aberta: o seu time em cima e Full Account embaixo
Clique em Create. O token aparece uma vez só. Clique em copiar.
No painel do AFK, abra Conexões, clique no cartão Vercel, cole no campo Token da Vercel, clique em Salvar conexão e depois em Testar.

No dia a dia

Você quer	Como
Publicar o site	Diga ao AFK "publica o site". Ele confere a página e pergunta antes de pôr no ar.
Ver se subiu	Na Vercel, aba Deployments: o mais novo em cima, com Ready quando terminou.
Voltar para a versão anterior	Na página do projeto, no quadro da produção, clique em Instant Rollback, escolha a versão e clique em Confirm Rollback. No Hobby, volta só para a versão imediatamente anterior. Atenção: depois disso, os envios novos não entram no ar sozinhos. Quando consertar, clique em Undo Rollback.
Trocar uma chave do site	Settings → Environment Variables, edite e publique de novo.
Ver quanto gastou	Usage no painel do time.
Pôr um teto de gasto (Pro)	Settings → Billing → Spend Management: ligue, defina o On-Demand Budget e ligue Pause Production Deployments. Só o valor não para nada: é a pausa que segura o gasto, com alguns minutos de atraso.

Erros e soluções

O que aparece	O que fazer
`Not authorized` ou `invalid token`	O token venceu, foi apagado ou é de outro escopo. Crie outro e cole por cima.
O deploy vai para o time errado	O escopo do token é outro time. Crie outro token com o escopo certo.
`Build failed`	Abra a publicação e leia Build Logs até a primeira linha vermelha. Mande essa linha ao AFK: "o deploy falhou com este erro".
O site pede login da Vercel para abrir	O endereço com código no meio (`projeto-abc123-time.vercel.app`) é privado. Use o endereço do projeto ou o seu domínio.
Domínio com Invalid Configuration	O registro está diferente do que a Vercel pede, ou a nuvem da Cloudflare está laranja. Confira letra por letra e espere a propagação.
`vercel` não é reconhecido	Feche o terminal e abra de novo. Se continuar, instale o Node.js e rode `npm i -g vercel` outra vez.
Projeto pausado	Uso comercial no Hobby ou limite do plano estourado. Veja o aviso no painel e, se for negócio, passe para o Pro.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o token.

Fontes oficiais (conferido em 30/10/2026): vercel.com/docs/plans/hobby (Hobby grátis, só uso pessoal e não comercial; Pro US$ 20 por usuário desenvolvedor por mês) · vercel.com/docs/cli (instalação, login, deploy, env) · vercel.com/docs/getting-started-with-vercel (importar repositório; cada envio publica) · vercel.com/docs/two-factor-authentication · vercel.com/docs/instant-rollback (Hobby volta só uma versão; Undo Rollback) · vercel.com/docs/domains/set-up-custom-domain · vercel.com/docs/spend-management (o valor sozinho não para; a pausa para) · vercel.com/docs/limits/fair-use-guidelines · vercel.com/account/settings/tokens.

trilha Criar site ou app · passo 2 de 3

próximoSupabase do zero: conta, projeto seguro, chaves e o dia a dia do banco

ainda não tem o AFK?

Com o AFK, você pede "publica o site" e ele confere, pergunta e publica. Sem decorar comando.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.