Deploy
In questa pagina
Una build di sitelo è fatta di semplici file statici: sitelo build scrive HTML, CSS e JS in dist/. Va bene qualunque host statico — le configurazioni qui sotto presuppongono soltanto npm run build → dist/.
Gli URL puliti sono cartelle con un index.html (/about/index.html → /about), quindi gli URL eleganti funzionano da subito senza regole di redirect. Una 404.html viene prodotta automaticamente — la convenzione che Netlify, Cloudflare Pages e GitHub Pages capiscono tutti.
Versioni pronte da copiare di tutte queste si trovano nell’esempio di base (examples/basic nel repository).
Host statici
Questi host compilano il sito e servono dist/ dalla propria CDN.
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 ora consiglia Workers invece di Pages per i nuovi progetti. Con questa configurazione, npx wrangler deploy compila il sito e carica dist/, e collegando il repository nella dashboard di Cloudflare lo stesso comando parte a ogni push. html_handling: "drop-trailing-slash" serve /about senza redirect, e gli URL sconosciuti ricevono 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"
}
}Ancora su Pages? Imposta il comando di build npm run build e la cartella di output dist, oppure carica una build locale con 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
Tieni il bucket privato e metti CloudFront davanti con origin access control. CloudFront associa solo / a index.html, quindi collega questa funzione alle richieste viewer della distribuzione per servire gli URL puliti di sitelo.
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
}Un bucket privato risponde 403 quando manca un file, quindi aggiungi risposte di errore personalizzate per 403 e 404 che restituiscano /404.html con stato 404. Poi carica ogni build e svuota la 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
Crea la Static Web App nel portale di Azure con / come posizione dell’app e dist come posizione di output; Azure aggiunge al repository un workflow di GitHub Actions che esegue npm run build. Metti questo file in public/ così la build lo copia in dist/ — senza, Azure risponde agli URL sconosciuti con la propria pagina di errore invece di 404.html.
{
"responseOverrides": {
"404": {
"rewrite": "/404.html"
}
}
}Firebase Hosting
Su Firebase Hosting, scegli un progetto con firebase use --add, poi esegui firebase deploy — l’hook predeploy compila prima. Gli URL sconosciuti ricevono 404.html in automatico, e trailingSlash: false serve /about senza redirect.
{
"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@v5Pubblichi sotto un sottopercorso (user.github.io/repo)? Fai la build con --base /repo/.
GitLab Pages
GitLab serve 404.html e gli URL di cartella da solo, quindi il job si limita a compilare e pubblicare 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
Aggiungi il Blueprint qui sotto al repository, oppure crea un sito statico dalla dashboard con lo stesso comando di build e la stessa cartella di pubblicazione. Gli URL puliti e 404.html funzionano senza regole di redirect.
# Render
services:
- type: web
name: my-site
runtime: static
buildCommand: npm install && npm run build
staticPublishPath: ./distDigitalOcean App Platform
Imposta il tuo repository in github.repo, poi crea l’app con doctl apps create --spec .do/app.yaml — oppure incolla la spec nella dashboard. App Platform risolve gli URL di cartella e serve 404.html per impostazione predefinita.
# 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: distHost di container
Questi host eseguono un container, e un solo Dockerfile li copre tutti: Node compila il sito, poi Caddy serve dist/ con URL puliti e risponde a quelli sconosciuti con 404.html. Caddy ascolta su PORT quando l’host lo imposta, altrimenti sulla porta 80. Aggiungi tutti e tre i file alla radice del progetto.
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 compila il Dockerfile ogni volta che ne trova uno, quindi non c’è niente da impostare. Senza Dockerfile, aggiungi la variabile di servizio RAILPACK_SPA_OUTPUT_DIR=dist e tieni il Caddyfile: Railpack serve allora dist/ tramite questo invece della configurazione predefinita per le SPA, che risponde agli URL sconosciuti con la home page.
Fly.io
Esegui fly launch per creare l’app, poi 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 compila il Dockerfile tramite heroku.yml. Passa l’app allo stack container una volta con heroku stack:set container, poi esegui git push heroku main.
# Heroku
build:
docker:
web: DockerfileGoogle Cloud Run
Esegui gcloud run deploy --source . dalla radice del progetto: Cloud Build compila il Dockerfile e Cloud Run lo serve.
Il tuo server
Copia la build sul server con rsync -a --delete dist/ you@server:/var/www/my-site/ e servila con Caddy o nginx — gli URL puliti e 404.html funzionano come sugli host qui sopra. Caddy ottiene da solo un certificato HTTPS per il dominio; con nginx, aggiungine uno con 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;
}Prima di pubblicare
- Imposta
siteinsitelo.config.jscosì viene generata lasitemap.xml— vedi Configurazione - Aggiungi un
src/404.ht.jsper una pagina “non trovato” con la tua identità (altrimenti ne viene prodotta una predefinita e pulita) sitelo previewserve la build di produzione in locale per un ultimo controllo