Informazioni
sitelo non è nato come framework. È nato dal desiderio di scrivere markup in un modo che risultasse naturale in JavaScript — e ha continuato a crescere finché non ha coperto tutto il percorso dal file di una pagina al sito pubblicato.
javascript-to-html
Prima è arrivato javascript-to-html (noto anche come ht.js): un modo semplice e intuitivo per generare HTML in JavaScript, senza motori di template o framework complessi.
Vista quanto erano diventati onnipresenti framework completi come React, trovare una soluzione di templating semplice che non portasse con sé mezzo mondo era sorprendentemente difficile. Concentrandosi solo sulla trasformazione da JavaScript a HTML — in sostanza funzioni che restituiscono stringhe — ht.js resta leggero, facile da usare, flessibile ed estensibile.
Quella superficie ridotta gli permette di stare in molti posti: direttamente nel frontend (in stile SPA), in una build per creare siti statici (SSG), o perfino per il rendering lato server (SSR).
Insegnare a Vite a produrre HTML
Questo risolveva la scrittura. Il problema successivo era la build: Vite tratta .js e .ts come script, non come pagine. Serviva una convenzione in cui certi moduli fossero destinati a diventare HTML.
L’idea era lineare: i file chiamati *.ht.js, *.html.js, *.ht.ts e simili dovevano essere trasformati in HTML invece di finire nel bundle come JavaScript per il browser. Quella convenzione è diventata vite-plugin-html-pages — routing basato sui file, caricamento dati, risorse e generazione statica sopra a Vite.
sitelo
sitelo racchiude Vite e quel plugin in una sola installazione e una sola CLI. Ottieni un’esperienza di sviluppo completa e di primo livello: sitelo per un server dal vivo, sitelo build per la produzione, impostazioni predefinite sensate e il modello di pagina del plugin senza doverti assemblare la toolchain da solo.
La stessa idea fino in fondo: le pagine sono moduli che restituiscono HTML. sitelo è lo strato che fa sembrare quell’idea finita.
Come si colloca
Esistono già parecchi buoni strumenti per pubblicare siti statici. La nicchia di sitelo è volutamente stretta: funzioni JavaScript (o TypeScript) che restituiscono HTML, con l’esperienza di sviluppo di Vite e il minimo framework possibile.
| Strumento | Modello | Scegli questo quando |
|---|---|---|
| sitelo | Funzioni JS/TS → HTML su Vite | Vuoi HTML a partire da JavaScript con un vero flusso di lavoro Vite — senza bisogno di un framework a componenti |
| Astro | Componenti + island, compilatore proprio | Siti di contenuti che vogliono island a componenti e un ecosistema più ampio |
| Next.js | App React completa (SSR / SSG / ISR) | Stai costruendo un’applicazione nell’ecosistema React |
| Hugo | Template Go, build velocissime | Siti di contenuti enormi e ti trovi bene con la toolchain di Go |
| Eleventy | Linguaggi di template → HTML | Vuoi template flessibili (Nunjucks, Liquid, …) senza un framework SPA |
Se vuoi componenti, idratazione e un framework — usa un framework. Se vuoi file HTML a partire da funzioni JavaScript con l’esperienza di Vite, sitelo è lo strumento più piccolo che fa tutto il lavoro.