Vai al contenuto
← Tutti i progetti

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.

AstroTypeScriptTailwind CSSPages CMSNetlifyCloudflare

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.