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.
Componenti e island server
Le funzioni che restituiscono HTML si sono rivelate componibili fino in cima. sitelo-ui è una libreria di componenti costruita allo stesso modo — pulsanti, card, form, tabelle, modali e sezioni di pagina, ciascuno una funzione che restituisce una stringa. Niente compilatore, niente runtime, niente idratazione: quello che costruisci è quello che finisce in dist/.
Non tutte le zone di una pagina possono però essere statiche. Le island server mantengono la pagina statica e renderizzano su un server, quando la pagina viene visitata, solo le parti che hanno bisogno di dati freschi a ogni richiesta — i commenti sotto un post in cache, la disponibilità su una pagina prodotto. Un’island è, di nuovo, una funzione che restituisce HTML: la build pubblica il suo fallback e un loader minuscolo lo sostituisce con il frammento renderizzato.
Nessuna delle due cambia il modello. Ancora nessun framework lato client — solo HTML da funzioni, in fase di build o a ogni richiesta.
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, più componenti e island server | Vuoi HTML a partire da JavaScript con un vero flusso di lavoro Vite — componenti e zone per richiesta inclusi, senza framework lato client né idratazione |
| Astro | Componenti di framework + island client e server, compilatore proprio | Vuoi idratare componenti React, Vue o Svelte nel browser, con 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 lato client e idratazione — usa un framework. Se vuoi HTML a partire da funzioni JavaScript con l’esperienza di Vite — componenti e zone renderizzate sul server inclusi — sitelo è lo strumento più piccolo che fa tutto il lavoro.