Penerapan

Build sitelo adalah berkas statis biasa: sitelo build menulis HTML, CSS, dan JS ke dist/. Hosting statis mana pun bisa dipakai — konfigurasi di bawah hanya mengasumsikan npm run build → dist/.

URL bersih adalah direktori berisi index.html (/about/index.html → /about), jadi URL rapi bekerja begitu saja tanpa aturan pengalihan. Sebuah 404.html dihasilkan otomatis — konvensi yang dipahami Netlify, Cloudflare Pages, dan GitHub Pages.

Versi siap salin dari semua ini tersedia di contoh dasar (examples/basic di repositori).

Hosting statis

Hosting ini membangun situs dan menyajikan dist/ dari CDN mereka sendiri.

Netlify · Vercel · Cloudflare · AWS Amplify · AWS S3 + CloudFront · Azure Static Web Apps · Firebase Hosting · GitHub Pages · GitLab Pages · Render · DigitalOcean App Platform

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

Cloudflare kini menyarankan Workers alih-alih Pages untuk proyek baru. Dengan konfigurasi ini, npx wrangler deploy membangun situs dan mengunggah dist/, dan menghubungkan repositori di dasbor Cloudflare menjalankan perintah yang sama di setiap push. html_handling: "drop-trailing-slash" menyajikan /about tanpa pengalihan, dan URL tak dikenal mendapat 404.html.

// Cloudflare Workers
{
  "name": "my-site",
  "compatibility_date": "2026-10-01",
  "build": {
    "command": "npm run build"
  },
  "assets": {
    "directory": "./dist",
    "not_found_handling": "404-page",
    "html_handling": "drop-trailing-slash"
  }
}

Masih di Pages? Setel perintah build ke npm run build dan direktori keluaran ke dist, atau unggah build lokal dengan npx wrangler pages deploy dist.

AWS Amplify

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

AWS S3 + CloudFront

Biarkan bucket tetap privat dan pasang CloudFront di depannya dengan origin access control. CloudFront hanya memetakan / ke index.html, jadi pasang fungsi ini pada viewer request distribusi agar URL bersih sitelo berfungsi.

function handler(event) {
  var request = event.request
  var uri = request.uri

  if (uri.endsWith('/')) {
    request.uri += 'index.html'
  } else if (uri.slice(uri.lastIndexOf('/') + 1).indexOf('.') === -1) {
    request.uri += '/index.html'
  }

  return request
}

Bucket privat menjawab file yang hilang dengan 403, jadi tambahkan respons galat kustom untuk 403 dan 404 yang mengembalikan /404.html dengan status 404. Lalu unggah setiap build dan bersihkan cache:

npm run build
aws s3 sync dist/ s3://my-bucket --delete
aws cloudfront create-invalidation --distribution-id MY_DISTRIBUTION_ID --paths "/*"

Azure Static Web Apps

Buat Static Web App di portal Azure dengan lokasi aplikasi / dan lokasi keluaran dist; Azure akan menambahkan workflow GitHub Actions ke repositori yang menjalankan npm run build. Taruh file ini di public/ agar build menyalinnya ke dist/ — tanpa file ini, Azure menjawab URL tak dikenal dengan halaman galatnya sendiri, bukan 404.html.

{
  "responseOverrides": {
    "404": {
      "rewrite": "/404.html"
    }
  }
}

Firebase Hosting

Di Firebase Hosting, pilih proyek dengan firebase use --add, lalu jalankan firebase deploy — hook predeploy akan build lebih dulu. URL tak dikenal otomatis mendapat 404.html, dan trailingSlash: false menyajikan /about tanpa pengalihan.

{
  "hosting": {
    "public": "dist",
    "predeploy": "npm run build",
    "trailingSlash": false
  }
}

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@v7
      - uses: actions/setup-node@v7
        with:
          node-version: 24
      - run: npm ci && npm run build
      - uses: actions/upload-pages-artifact@v5
        with:
          path: dist
      - uses: actions/deploy-pages@v5

Menerapkan di bawah subjalur (user.github.io/repo)? Build dengan --base /repo/.

GitLab Pages

GitLab menyajikan 404.html dan URL direktori sendiri, jadi job ini hanya build dan menerbitkan dist/.

# GitLab Pages
deploy-pages:
  image: node:24
  script:
    - npm ci
    - npm run build
  pages:
    publish: dist
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

Render

Tambahkan Blueprint di bawah ini ke repositori, atau buat situs statis di dasbor dengan perintah build dan direktori publikasi yang sama. URL bersih dan 404.html berfungsi tanpa aturan pengalihan.

# Render
services:
  - type: web
    name: my-site
    runtime: static
    buildCommand: npm install && npm run build
    staticPublishPath: ./dist

DigitalOcean App Platform

Isi github.repo dengan repositori Anda, lalu buat aplikasinya dengan doctl apps create --spec .do/app.yaml — atau tempelkan spesifikasinya di dasbor. App Platform menyelesaikan URL direktori dan menyajikan 404.html secara bawaan.

# DigitalOcean App Platform
name: my-site
static_sites:
  - name: site
    github:
      repo: your-name/your-site
      branch: main
      deploy_on_push: true
    build_command: npm run build
    output_dir: dist

Hosting container

Hosting ini menjalankan container, dan satu Dockerfile cukup untuk semuanya: Node membangun situs, lalu Caddy menyajikan dist/ dengan URL bersih dan menjawab URL tak dikenal dengan 404.html. Caddy mendengarkan PORT bila host menyetelnya, dan port 80 bila tidak. Tambahkan ketiga file ke root proyek.

Railway · Fly.io · Heroku · Google Cloud Run

FROM node:24-slim AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM caddy:2-alpine
COPY Caddyfile /etc/caddy/Caddyfile
COPY --from=build /app/dist /app/dist
node_modules
dist
.git
:{$PORT:80} {
  root * /app/dist
  encode zstd gzip
  try_files {path} {path}/index.html
  file_server
  handle_errors {
    rewrite * /{err.status_code}.html
    file_server
  }
}

Railway

Railway membangun Dockerfile setiap kali menemukannya, jadi tidak ada yang perlu disetel. Tanpa Dockerfile, tambahkan variabel layanan RAILPACK_SPA_OUTPUT_DIR=dist dan pertahankan Caddyfile: Railpack lalu menyajikan dist/ lewat file itu, bukan lewat bawaan SPA-nya yang menjawab URL tak dikenal dengan halaman beranda.

Fly.io

Jalankan fly launch untuk membuat aplikasinya, lalu fly deploy.

# Fly.io
app = "my-site"

[http_service]
  internal_port = 80
  force_https = true
  auto_stop_machines = "stop"
  auto_start_machines = true
  min_machines_running = 0

Heroku

Heroku membangun Dockerfile lewat heroku.yml. Alihkan aplikasi ke stack container sekali dengan heroku stack:set container, lalu jalankan git push heroku main.

# Heroku
build:
  docker:
    web: Dockerfile

Google Cloud Run

Jalankan gcloud run deploy --source . dari root proyek: Cloud Build membangun Dockerfile dan Cloud Run menyajikannya.

Server Anda sendiri

Salin build ke server dengan rsync -a --delete dist/ you@server:/var/www/my-site/ lalu sajikan dengan Caddy atau nginx — URL bersih dan 404.html berfungsi sama seperti di hosting di atas. Caddy mengambil sertifikat HTTPS untuk domain sendiri; dengan nginx, tambahkan sertifikat lewat certbot.

example.com {
  root * /var/www/my-site
  encode zstd gzip
  try_files {path} {path}/index.html
  file_server
  handle_errors {
    rewrite * /{err.status_code}.html
    file_server
  }
}
server {
  listen 80;
  server_name example.com;
  root /var/www/my-site;

  location / {
    try_files $uri $uri/index.html =404;
  }

  error_page 404 /404.html;
}

Sebelum menerbitkan