guias
Projetos

Site Estático

Como fazer deploy de um site estático (HTML, Astro, Gatsby) na Veloz.

Faça deploy de um site estático na Veloz — HTML puro, Astro, Gatsby, ou qualquer gerador.

HTML puro

Se você tem apenas arquivos HTML, CSS e JS:

meu-site/
├── index.html
├── style.css
├── script.js
└── images/
    └── logo.png

Crie um package.json mínimo:

{
  "name": "meu-site",
  "scripts": {}
}
veloz deploy

A Veloz serve os arquivos diretamente. Simples assim.

Astro

npm create astro@latest meu-blog
cd meu-blog
veloz deploy
ℹ Framework detectado: Astro
ℹ Tipo: Site Estático
ℹ Build: npm run build
ℹ Output: dist

Astro com SSR

Se você usa Astro com output: "server", a Veloz detecta como serviço web automaticamente:

// astro.config.mjs
export default defineConfig({
  output: "server",
  adapter: node({ mode: "standalone" }),
});

Gatsby

npx gatsby new meu-site
cd meu-site
veloz deploy
ℹ Framework detectado: Gatsby
ℹ Tipo: Site Estático
ℹ Build: npm run build
ℹ Output: public

Performance

Sites estáticos na Veloz são servidos com:

  • CDN para assets (JS, CSS, imagens)
  • Gzip/Brotli compression automática
  • Cache headers otimizados
  • HTTPS automático

Domínio personalizado

veloz domains add meublog.com.br

Configure o DNS e o SSL é provisionado automaticamente.

Deploy automático

Conecte o GitHub para deploy a cada push:

  1. Instale o Veloz GitHub App
  2. Todo push na branch main dispara um build e deploy

Ou use GitHub Actions:

- name: Deploy
  run: veloz deploy --yes
  env:
    VELOZ_API_KEY: ${{ secrets.VELOZ_API_KEY }}

Próximos passos

  • Domínios — Configurar domínio personalizado
  • CI/CD — Deploy automático
  • Frameworks — Lista completa de frameworks suportados