Penerapan
Di halaman ini
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@v5Menerapkan 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_BRANCHRender
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: ./distDigitalOcean 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: distHosting 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/distnode_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 = 0Heroku
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: DockerfileGoogle 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
- Setel
sitedisitelo.config.jsagarsitemap.xmldihasilkan — lihat Konfigurasi - Tambahkan
src/404.ht.jsuntuk halaman tidak-ditemukan bermerek (jika tidak, versi bawaan yang rapi akan dihasilkan) sitelo previewmenyajikan build produksi secara lokal untuk pemeriksaan terakhir