Implementação

Uma compilação do sitelo são ficheiros estáticos e mais nada: sitelo build escreve HTML, CSS e JS em dist/. Qualquer alojamento estático serve — as configurações abaixo só assumem npm run build → dist/.

Os URLs limpos são diretórios com index.html (/about/index.html → /about), por isso os URLs bonitos funcionam logo, sem regras de redirecionamento. O 404.html é emitido automaticamente — é a convenção que o Netlify, o Cloudflare Pages e o GitHub Pages entendem.

Há versões prontas a copiar de tudo isto no exemplo básico (examples/basic no repositório).

Netlify

[build]
  command = "npm run build"
  publish = "dist"

Vercel

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "framework": null,
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "installCommand": "npm install"
}

Cloudflare Pages

Compilações pelo painel: comando de compilação npm run build e diretório de saída dist. Ou implementa pela CLI com npx wrangler pages deploy dist.

# Cloudflare Pages
name = "my-site"
compatibility_date = "2025-01-01"
pages_build_output_dir = "dist"

AWS Amplify

# Alojamento AWS Amplify
version: 1
frontend:
  phases:
    preBuild:
      commands:
        - npm install
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: dist
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

Para S3 + CloudFront simples: npm run build e depois sincroniza dist/ com o bucket.

GitHub Pages

# GitHub Pages
name: Deploy
on:
  push:
    branches: [main]
permissions:
  contents: read
  pages: write
  id-token: write
jobs:
  deploy:
    runs-on: ubuntu-latest
    environment:
      name: github-pages
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci && npm run build
      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist
      - uses: actions/deploy-pages@v4

Implementas num subcaminho (user.github.io/repo)? Compila com --base /repo/.

Antes de publicar