Deploy direto do terminal. Instale a CLI, autentique e rode `veloz deploy` na raiz do seu projeto.

Para quem mora no terminal. Quatro comandos do npm install ao app no ar.

1. Instale a CLI

npm i -g onveloz

Funciona com qualquer gerenciador (pnpm add -g onveloz, yarn global add onveloz, bun add -g onveloz). Requer Node 20+.

Verifique:

veloz --version

2. Autentique

veloz login

A CLI abre o navegador para você confirmar a sessão (Device Authorization Flow). Depois disso, qualquer comando da CLI vai usar essa autenticação.

Em ambientes não-interativos (CI), use uma API key:

VELOZ_API_KEY=veloz_xxx veloz deploy -y

→ Como criar API keys

3. Faça deploy

Na raiz do seu projeto:

veloz deploy

A CLI:

Detecta seu framework (Next.js, Nuxt, Remix, Astro, Hono, Express, NestJS, Fastify, SvelteKit, Gatsby, Vite, Angular, TanStack Start ou container Docker)
Detecta seu package manager (npm, pnpm, yarn, bun)
Resolve build/start commands olhando seu package.json
Lê variáveis de ambiente esperadas de .env.example e te pergunta os valores
Cria o projeto/serviço se não existir, faz upload do código e dispara o build
Mostra os logs do build em tempo real

Quando termina, você recebe a URL https://seu-projeto.onveloz.com com TLS válido.

Use veloz deploy -y para confirmar tudo automaticamente (ideal para CI).

4. Próximos deploys

Depois do primeiro deploy, a CLI cria um arquivo veloz.json na raiz com os IDs do projeto e serviço. Os deploys seguintes são instantâneos:

veloz deploy

Ou conecte ao GitHub e tenha auto-deploy a cada push:

veloz github setup

→ GitHub auto-deploy

Comandos do dia a dia

veloz logs show --follow         # acompanhar logs em tempo real
veloz logs search "error"        # busca com LogsQL
veloz metrics show               # latência, CPU, memória, requisições
veloz env set DATABASE_URL=...   # set/edit variáveis de ambiente
veloz env import .env            # importar tudo de uma vez
veloz domains add meuapp.com     # conectar domínio próprio
veloz db create                  # criar banco gerenciado
veloz services list              # listar serviços do projeto

→ Referência completa da CLI

Monorepos

Tem um monorepo com vários apps? A CLI detecta pnpm-workspace.yaml, package.json workspaces, Turborepo, Nx e Moon. Faça deploy de todos de uma vez:

veloz deploy --all                # deploy de todos os apps
veloz deploy --service api        # deploy de um serviço específico
veloz deploy --app apps/web       # deploy por path

→ Monorepo

Modo IA / MCP

A CLI da Veloz tem MCP server embutido. Conecte ao Claude Code, Cursor, Windsurf ou Claude Desktop com:

veloz mcp add

A partir daí, sua IDE pode rodar qualquer comando da Veloz por você — db_list, logs_search, deploy, etc.

→ MCP · Deploy com IA

Quickstart — pela CLI