Deploy com IA — Veloz Docs

Como usar Cursor, Claude, Copilot ou qualquer AI para fazer deploy na Veloz sem sair do chat.

Você usa Cursor, Claude, Copilot, ou qualquer outra IA pra codar? Então você pode fazer deploy sem sair do chat. Literalmente: pede pra IA e ela faz.

Por que isso funciona?

A Veloz CLI foi feita pra ser usada por humanos e por IAs. Os comandos são simples, as mensagens são claras, e tudo funciona no terminal — exatamente onde sua IA já opera.

Setup inicial (uma vez só)

Pede pra sua IA:

"Instala a CLI da Veloz e faz login"

Ela vai rodar:

npm install -g onveloz
veloz login

O login abre o navegador. Confirme e pronto.

Fazendo deploy

Agora é só pedir:

"Faz deploy desse projeto na Veloz"

A IA vai rodar:

veloz deploy

A CLI detecta automaticamente:

Framework (Next.js, Vite, Remix, etc.)
Comando de build
Comando de start
Porta

Exemplos de prompts que funcionam

Deploy básico

"Sobe isso pra produção"

Deploy com variáveis de ambiente

"Faz deploy e configura DATABASE_URL como postgres://..."

veloz env set DATABASE_URL "postgres://user:pass@host/db"
veloz deploy

Ver status do deploy

"Qual o status do meu deploy?"

veloz status

Ver logs em tempo real

"Mostra os logs do meu app"

veloz logs

Rollback se deu ruim

"Volta pra versão anterior"

veloz rollback

Configuração avançada com veloz.json

Se a detecção automática não pegou algo, pede pra IA criar o veloz.json:

"Cria um veloz.json pro meu projeto Next.js com porta 3000"

{
  "name": "meu-app",
  "framework": "nextjs",
  "build": "npm run build",
  "start": "npm start",
  "port": 3000,
  "env": {
    "NODE_ENV": "production"
  }
}

Monorepos

Usando Turborepo ou pnpm workspaces?

"Faz deploy só do app web que tá em apps/web"

veloz deploy --dir apps/web

Dicas pro-gamer

1. Deixe a IA resolver os erros

Se o deploy falhar, cola o erro no chat:

"Deu esse erro no deploy: [erro]. Arruma?"

A IA geralmente sabe exatamente o que fazer.

2. Health checks

"Configura health check em /api/health"

{
  "healthCheck": "/api/health"
}

3. Domínio customizado

"Configura meuapp.com.br como domínio"

veloz domains add meuapp.com.br

Comandos que sua IA precisa saber

Comando	O que faz
`veloz deploy`	Faz o deploy
`veloz status`	Status do app
`veloz logs`	Logs em tempo real
`veloz logs --lines 100`	Últimas 100 linhas
`veloz env set KEY value`	Define variável
`veloz env list`	Lista variáveis
`veloz rollback`	Volta versão anterior
`veloz domains add`	Adiciona domínio
`veloz stop`	Para o app
`veloz restart`	Reinicia o app

O fluxo perfeito

Você coda com a IA
Terminou? Pede: "Faz deploy"
A IA roda veloz deploy
Em 2 minutos tá no ar
Deu erro? Cola o erro, a IA arruma

Sem sair do chat. Sem abrir dashboard. Sem complicação.

Começando agora

Se você ainda não tem conta:

npm install -g onveloz
veloz login
veloz deploy

Três comandos. Seu app no ar. Feito pra vibecoders que deixam a IA trabalhar.