PogonaItalia: la guida alla pogona che si esplora dal suo terrario, con la community di chi la alleva

Guida e community italiana sulla cura della Pogona vitticeps. La home è il suo terrario, in foto e in 3D: ogni oggetto, dalla lampada alle ciotole, apre la sua pagina della guida. Dentro ci sono sette argomenti che partono dall'essenziale, approfondimenti con le fonti, un glossario che si apre nel testo e un forum con categorie, soluzioni scelte e moderazione.

**PogonaItalia** è una guida, con la sua community, per chi vive con una pogona (*Pogona vitticeps*) o sta per prenderne una. È nata per chi oggi si informa nei gruppi Facebook, dove i consigli si contraddicono: qui i testi sono originali, scritti sulle linee guida più aggiornate e sulla letteratura scientifica, e la community dice le stesse cose della guida.

**Che cosa fa**

- **Il terrario**: la home è un terrario allestito come chiede la guida, con le tre luci sovrapposte sul punto basking e l'ombra intorno. I nove oggetti si toccano, e ognuno apre la sua pagina. La foto si muove col mouse, mette a fuoco l'oggetto indicato e ha la sua notte; c'è anche una versione 3D, e l'amministratore sceglie quale mostrare. - **La guida**: sette argomenti che cominciano dall'essenziale, in trenta secondi, con le sezioni che si aprono per chi vuole i dettagli; undici approfondimenti con le fonti; un glossario di 40 voci che si spiega dentro il testo; tre percorsi di lettura, secondo chi arriva. - **La community**: discussioni per categoria, risposte utili, la soluzione scelta da chi chiede, foto, menzioni, notifiche nella campanella e per email, segnalazioni e moderazione. Finché le iscrizioni non si aprono ci sono 46 discussioni d'esempio fra 31 membri inventati, segnate una per una. - **Le statistiche delle visite**, senza cookie: l'indirizzo IP non si salva mai.

**La parte difficile**

Il terrario in foto è un solo shader WebGL2. La foto si sposta con la sua mappa di profondità, e ogni pixel cerca la superficie che incontra lungo lo spostamento: così, con il mouse ai lati, i bordi della teca non si sdoppiano. Le foto le ho rifatte con ChatGPT partendo da una nata dal terrario 3D, e le ho controllate sulle linee guida: un ramo che arrivava quasi al tubo UVB, la ciotola dell'acqua troppo grande, il fondo a granuli e un termometro a 31,6 °C all'ombra sono stati corretti prima di pubblicarle. La versione verticale per il telefono è allargata sulla GPU del mio computer con Z-Image-Turbo, partendo da una traccia di parete e cassetti, e la profondità viene da Depth Anything V2. La foto del giorno pesa 191 KB; quella della notte, 83 KB, si scarica solo quando qualcuno passa alla notte.

La versione 3D è tutta procedurale, senza modelli da scaricare: anche la pogona, con lo scheletro, le spine e la barba fatti in codice.

Vue 3 e TypeScript, Fastify e MongoDB, con gli schemi Zod condivisi fra sito e server in un monorepo pnpm, e three.js per il 3D. Ogni modifica passa da 95 prove automatiche e arriva sul server con una GitHub Action.

Progettazione, sviluppo full-stack e pubblicazione · 2026

Vue.js, Fastify, MongoDB, three.js, ChatGPT

Vedi il sito

Andrea Coppetta