Teyvat Center
Un sito di contenuti costruito da zero e portato online su un dominio proprio: Astro per la generazione statica, Pages CMS per la redazione senza backend, deploy su Netlify e DNS su Cloudflare. Niente cookie, niente analytics, niente risorse di terze parti — e un deploy che parte solo quando lo si chiede davvero.
La sfida che ho risolto
Netlify è passato ai piani a crediti: ogni deploy di produzione costa 15 dei 300 crediti mensili del piano gratuito, e ogni salvataggio dal CMS è un commit che fa partire una build — sarebbero bastati venti salvataggi per bruciare il mese. La soluzione è uno script di ignore che annulla le build dei push normali, a costo zero: il deploy parte solo su richiesta, con un tag nel messaggio di commit o dal build hook di Netlify.
Perché è nato
Teyvat Center raccoglie guide e analisi in italiano sui personaggi di Genshin Impact. Al di là del tema, per me è stato il banco di prova di un’idea precisa: un sito di contenuti interamente statico, dove chi scrive lavora da un CMS senza sapere cosa sia git, e dove “nessun tracciamento” non è una frase dell’informativa ma una garanzia tecnica. Il sito non usa cookie, analytics né risorse di terze parti, e la Content Security Policy impostata sugli header blocca qualunque richiesta verso domini esterni: se un domani qualcosa provasse a chiamare fuori, semplicemente non funzionerebbe.
Il deploy: Netlify e il problema dei crediti
Il sito è pubblicato su Netlify, collegato al repository GitHub: tutta la
configurazione — comando di build, header di sicurezza, regole di cache — vive
in un unico netlify.toml versionato insieme al codice. Il dominio è
registrato su Cloudflare, che qui fa solo da registrar e da DNS (proxy
spento): Netlify ha già la sua CDN e si emette e rinnova da solo il
certificato HTTPS.
Il nodo da sciogliere è arrivato con i piani a crediti di Netlify: ogni
deploy di produzione costa 15 dei 300 crediti mensili inclusi nel piano
gratuito. Peccato che ogni salvataggio dal CMS sia un commit, e ogni commit
facesse partire una build: venti salvataggi — una sessione di scrittura
normale — e il mese era finito. La soluzione sta in una riga di ignore nel
netlify.toml: le build dei push ordinari vengono annullate, e una build
annullata non costa nulla. Quando i contenuti sono pronti, il deploy si lancia
apposta — con il tag [deploy] nel messaggio di commit oppure dal build hook,
che lo script lo scavalca sempre. Risultato: decine di salvataggi al giorno,
un solo deploy quando serve.
Perché Pages CMS
Pages CMS è la scelta che tiene in piedi tutto il resto. È un’app ospitata (app.pagescms.org): non c’è nulla da installare nel repository, nulla da far girare sul server, niente chiavi API. Si collega a GitHub tramite una GitHub App e scrive direttamente file Markdown nel repository — ogni salvataggio è un commit, quindi lo storico delle modifiche è quello di git, gratis. Il sito resta così completamente statico: nessuna funzione serverless, nessun endpoint di autenticazione, nessun database da mantenere o da difendere.
L’interfaccia di redazione si costruisce da sola a partire da un unico file YAML nel repository: campi strutturati, elenchi ripetibili, bozze, e riferimenti fra collezioni che nel CMS diventano menù a tendina — chi scrive sceglie da un elenco invece di digitare testo libero, e gli errori di battitura spariscono alla radice. Uno script di verifica tiene allineati lo schema del CMS e quello del sito, così un campo aggiunto da una parte sola non può rompere le cose in silenzio.
Tecnologie usate
Il sito è costruito con Astro in output statico: ogni pagina è un file HTML, servito dalla CDN senza JavaScript superfluo. I contenuti vivono in content collections tipizzate con TypeScript e validate alla build: un riferimento sbagliato non produce una pagina rotta, ferma la build con un messaggio che dice quali valori sono ammessi. L’interfaccia usa Tailwind CSS con componenti Starwind adattati al design del sito, e una serie di script Node tiene aggiornate le anagrafiche di gioco dalle API pubbliche senza mai sovrascrivere le correzioni fatte a mano.