blog
Deploy

Seu primeiro deploy em 5 minutos

Do zero ao app no ar. O guia mais rápido para vibecoders que nunca fizeram deploy.

hidden: true

Seu primeiro deploy em 5 minutos

Você tem um app. Vamos colocá-lo no ar. Sem teoria — direto ao ponto.

Requisitos

  • Node.js instalado
  • Um projeto que roda com npm run dev

Passo 1: Instalar a CLI (30 segundos)

npm install -g onveloz

Passo 2: Login (30 segundos)

veloz login

Abre o navegador, confirme a autenticação.

Passo 3: Deploy (3 minutos)

cd meu-projeto
veloz deploy

A CLI detecta tudo automaticamente:

ℹ Framework detectado: Next.js
ℹ Build: npm run build
ℹ Start: npm start

? Confirmar e fazer deploy? (Y/n) y

✓ Build concluído em 25s
✓ Deploy concluído!
✓ https://meu-projeto.onveloz.com

Passo 4: Celebrar 🎉

Abra a URL. Seu app está no ar. Compartilhe com quem quiser.

E agora?

# Adicionar domínio próprio
veloz domains add meuapp.com.br
 
# Configurar variáveis de ambiente
veloz env set DATABASE_URL=postgres://...
 
# Ver logs
veloz logs show
 
# Fazer novo deploy após mudanças
veloz deploy

Próximos deploys

Depois do primeiro, é ainda mais rápido:

# Editou o código? Deploy em 1 comando:
veloz deploy

Ou configure deploy automático via GitHub — todo git push deploya automaticamente.