docs
Começando

Primeiro Deploy

Como funciona o fluxo de deploy na Veloz.

O comando veloz deploy cuida de tudo — detecção de framework, criação de projeto, upload e build.

Requisitos

  • CLI instalada e autenticada (veloz login)
  • Repositório git com remote origin configurado

Fluxo do primeiro deploy

cd meu-projeto
veloz deploy

A CLI segue este fluxo:

1. Detecta o repositório git

Lê o remote origin para identificar owner e nome do repo.

  ℹ Detectando repositório git...
    Repositório: usuario/meu-projeto

2. Busca projeto existente

Se o repo já tem um projeto na Veloz, usa ele. Senão, cria um novo (pede o nome do projeto interativamente).

3. Detecta o framework

Analisa package.json, lockfiles e estrutura do projeto:

  ℹ Framework detectado: Next.js

  ────────────────────────────────────────
    Nome:          meu-projeto
    Tipo:          Serviço Web
    Branch:        main
    Framework:     Next.js
    Package Mgr:   pnpm
    Build:         pnpm run build
    Start:         pnpm run start
    Porta:         3000
  ────────────────────────────────────────

  Confirmar e fazer deploy? (s/N)

Se você recusar a confirmação, pode editar nome, tipo, build command, start command e porta.

Tipos disponíveis:

  • Web — Servidor HTTP (APIs, Next.js, Express)
  • Static — Site estático (HTML/CSS/JS)
  • Worker — Processo em background (filas, crons, consumidores)

4. Detecta variáveis de ambiente

Se encontrar um .env.example ou .env, oferece para preencher as variáveis:

  📝 3 variável(is) de ambiente detectada(s):

    • DATABASE_URL
    • API_KEY
    • NEXT_PUBLIC_URL

  Deseja preencher as variáveis agora? (s/N)

5. Upload e build

  ⠋ Fazendo upload do código...
  ✓ Deploy iniciado com sucesso!

A CLI faz stream dos logs de build em tempo real até o deploy finalizar.

Deploys subsequentes

Após o primeiro deploy, um arquivo veloz.json é criado na raiz do projeto. Deploys seguintes usam essa configuração diretamente — sem precisar reconfigurar.

veloz deploy

Deploy em monorepo

Se a CLI detectar um monorepo (pnpm workspaces, npm workspaces), ela oferece uma seleção interativa:

  ℹ Monorepo detectado (pnpm)

  Quais apps deseja fazer o deploy?
  ◉ web (Next.js) — apps/web
  ◉ server (Hono) — apps/server
  ○ cli — apps/cli

Os serviços selecionados são criados e deployados em paralelo.

Para deployar todos os serviços de um monorepo já configurado:

veloz deploy --all

Próximos passos