Fazer deploy ↗
docs

Quickstart com veloz init

O caminho mais rápido para colocar um app no ar. `veloz init` detecta seu framework, configura tudo e sobe o primeiro deploy em um único comando.

veloz init é o caminho recomendado para o primeiro contato com a Veloz. Em um único comando você instala a CLI, autentica, configura o projeto, faz o primeiro deploy e conecta seu agente de IA.

TL;DR

npm i -g onveloz
veloz init

É isso. Em menos de 60 segundos seu app está no ar com URL pública e TLS válido.

Requisitos

  • Node 20 ou superior
  • Um projeto na sua máquina (Next.js, Nuxt, Remix, Astro, Hono, Express, NestJS, Fastify, SvelteKit, Vite, Angular, TanStack Start, Rails, Phoenix, FastAPI, ou qualquer container Docker)

O que o wizard faz

  1. Detecta seu stack. Identifica framework, package manager (npm/pnpm/yarn/bun), comandos de build/start e variáveis de ambiente esperadas.
  2. Pede confirmação. Você revisa o que foi detectado e ajusta o que quiser antes de subir.
  3. Cria projeto e serviço. Se você ainda não tem nada na Veloz, ele resolve isso. Se já tem, vincula ao existente.
  4. Faz o primeiro deploy. Upload do código, build remoto, logs ao vivo no terminal.
  5. Oferece auto-deploy via GitHub. Se você quiser, registra o webhook e a partir daí cada push para main faz deploy automático.
  6. Conecta seu agente de IA. Detecta Claude Code, Cursor, Windsurf, Claude Desktop, Codex CLI e oferece registrar a CLI como servidor MCP. Sua IDE de IA passa a rodar comandos Veloz nativamente.

Tudo isso interativo. Você pode pular qualquer passo.

Modo headless (CI)

Para automação onde não há terminal interativo:

veloz init --ci

Combine com VELOZ_API_KEY para autenticar sem login pelo navegador:

VELOZ_API_KEY=veloz_xxx veloz init --ci

Útil para scripts de bootstrap, GitHub Actions ou pipelines que provisionam ambientes do zero.

Forçando um framework

A detecção é bem precisa, mas se você precisar sobrescrever:

veloz init -f nextjs
veloz init --framework hono

Frameworks suportados: nextjs, nuxt, remix, astro, sveltekit, vite, angular, gatsby, tanstack-start, hono, express, fastify, nestjs, rails, phoenix, fastapi, docker.

Depois do init

Você terá um veloz.json na raiz com os IDs do projeto e serviço. Não edite os campos id, mas os outros (build, runtime, size, env) são livres. Veja veloz.json.

Comandos do dia a dia:

veloz deploy                     # novo deploy
veloz logs show --follow         # logs em tempo real
veloz metrics show               # latência, CPU, memória
veloz env set DATABASE_URL=...   # variáveis de ambiente
veloz domains add meuapp.com     # domínio próprio

→ Referência completa da CLI

Tem GitHub conectado?

Se você aceitou o passo de auto-deploy, cada git push para a branch configurada dispara um build novo. Para mudar a branch ou desconectar, veja GitHub auto-deploy.

Conectou o agente de IA?

Sua IDE agora tem acesso a todos os comandos da Veloz como ferramentas MCP. Pode pedir coisas como:

"Faz deploy desse projeto."

"Procura erros 500 nos logs do api na última hora."

"Cria um Postgres essencial e adiciona o DATABASE_URL ao web."

Veja MCP & Agentes IA para a lista completa de ferramentas expostas.

Quando não usar veloz init

Para deploys em projetos já configurados (que já têm veloz.json), use veloz deploy direto. O wizard é otimizado para o primeiro contato.

Para configuração 100% manual sem wizard, veja Quickstart pela CLI.

Próximos passos