Frameworks

A Veloz detecta seu framework automaticamente pelo package.json. Não precisa configurar nada — basta rodar veloz deploy.

Frameworks suportados

Aplicações Web (SSR)

Frameworks que rodam um servidor em produção.

Sites Estáticos (SPA / SSG)

Frameworks que geram arquivos estáticos no build.

Node.js genérico

Se nenhum framework específico for detectado mas existirem scripts build ou start no package.json, a Veloz trata como um projeto Node.js genérico:

• Com script start → Serviço Web (porta 3000)
• Sem script start → Site Estático (output dist)

Como funciona a detecção

1. A CLI lê o package.json do seu projeto
2. Verifica dependencies e devDependencies contra a lista de frameworks
3. O primeiro framework que corresponder é usado (ordem de prioridade)
4. Build e start commands são configurados automaticamente

Ordem de prioridade

Se seu projeto tem múltiplas dependências (ex: next + express), a Veloz usa o primeiro match na lista. Next.js tem prioridade sobre Express.

Package managers

A Veloz detecta o package manager pelo lockfile:

Os comandos de build e start são adaptados automaticamente:

# npm
npm run build && npm start
 
# pnpm
pnpm run build && pnpm start
 
# yarn
yarn build && yarn start
 
# bun
bun run build && bun run start

Customizando

Se a detecção automática não funcionar para o seu caso, você pode definir os comandos manualmente:

Via CLI

veloz config set --build-command "npm run build:custom" --start-command "node server.js" --port 8080

Via veloz.json

{
  "services": {
    ".": {
      "build": {
        "command": "npm run build:custom"
      },
      "runtime": {
        "command": "node server.js",
        "port": 8080
      }
    }
  }
}

No primeiro deploy

Se você recusar a confirmação automática, a CLI permite editar todos os campos:

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

  Build command: (npm run build) npm run build:custom
  Start command: (npm start) node server.js
  Port: (3000) 8080

Variáveis de ambiente

A Veloz também detecta variáveis de ambiente automaticamente a partir de:

• .env.example
• .env.sample
• .env.local.example
• .env

No primeiro deploy, a CLI lista as variáveis encontradas e pergunta se você quer preenchê-las.

Dependências do sistema

Alguns frameworks e bibliotecas precisam de pacotes do sistema para funcionar. Use aptPackages no veloz.json:

"build": {
  "aptPackages": ["ffmpeg", "libvips-dev"]
}

Casos comuns:

Para a lista completa e exemplos detalhados, veja Pacotes do Sistema.

Próximos passos

• Primeiro Deploy — Faça seu primeiro deploy
• veloz.json — Referência de configuração
• Pacotes do Sistema — Instalar dependências nativas
• Monorepo — Deploy de múltiplos apps