biagiojs

Deploy & cache

SSG puro (consigliato)

npm run build
# dist/ → upload su Cloudflare Pages, Netlify, Vercel, S3…

Nessun server Node richiesto. HTML statico, asset con hash, sitemap inclusa.

Cache headers

In biagio.config.js:

site: { cache: true }

Genera dist/_headers con regole per CDN:

/img/*
  ! Cache-Control: public, max-age=31536000, immutable
/*.html
  Cache-Control: public, max-age=0, must-revalidate

Il prefisso ! forza Cache-Control su Cloudflare Pages anche con regole generiche /*.

Preset deploy

site: { deploy: 'cloudflare' }  // o 'vercel' | 'netlify'

Alla build, se i file non esistono già, vengono generati:

PlatformFile
Cloudflarewrangler.toml, functions/[[path]].js
Vercelvercel.json, api/ssr.js
Netlifynetlify.toml, netlify/functions/ssr.mjs

Preview locale

biagio preview . 3000

Server Node con statico + ISR + SSR on-demand + compressione gzip/brotli.

SSR / ISR

Per pagine con prerender = false o revalidate = N:

AdapterImport
Nodebiagiojs/adapters/node
Vercelbiagiojs/adapters/vercel
Cloudflarebiagiojs/adapters/cloudflare
import { createBiagioServer } from 'biagiojs/adapters/node';
createBiagioServer('.').listen(3000);

Node version

Richiede Node ≥ 18 in build e runtime (adapter).

Questo sito docs

Questo sito è deployato come SSG puro. È costruito con biagiojs — landing in .biagio, guide da Markdown, una sola isola interattiva sulla homepage.