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.

StrumentoModelloScegli questo quando
siteloFunzioni JS/TS → HTML su Vite, più componenti e island serverVuoi HTML a partire da JavaScript con un vero flusso di lavoro Vite — componenti e zone per richiesta inclusi, senza framework lato client né idratazione
AstroComponenti di framework + island client e server, compilatore proprioVuoi idratare componenti React, Vue o Svelte nel browser, con un ecosistema più ampio
Next.jsApp React completa (SSR / SSG / ISR)Stai costruendo un’applicazione nell’ecosistema React
HugoTemplate Go, build velocissimeSiti di contenuti enormi e ti trovi bene con la toolchain di Go
EleventyLinguaggi di template → HTMLVuoi 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.

Leggi la documentazione · GitHub