
Il blog di Pauperwave: sette anni di Pauper da WordPress a Nuxt
Un piano scritto nel 2025 e riletto un anno dopo, poi sette anni di articoli sul Pauper spostati da un WordPress gratuito a un sito statico: i componenti per chi scrive, l'anteprima delle carte e un design che segue il calendario.
Emanuele Nardi
A settembre 2025 ho iniziato un nuovo progetto. Volevo imparare Nuxt, e avevo un problema concreto: l'associazione Pauperwave aveva il blog su un WordPress gratuito e la gestione dei tornei di Magic scritta in React, con un backend Java Spring Boot.
Il piano di partenza era questo: un blog pubblico con Nuxt Content, una dashboard per gli admin, l'inserimento dei risultati in tempo reale per gli associati, la gestione delle tessere, il tutto su Supabase e Vercel. L'ho portato avanti da solo, e ho iniziato a usare Claude Code solo a luglio 2026, a metà strada. Poco più di un anno dopo sono tornato a quel piano per vedere cosa ne è rimasto.
Il piano, un anno dopo
Supabase ha preso davvero il posto del backend Java. Database, autenticazione e realtime stanno lì, e lo schema è versionato nel codice, in 164 migrazioni, invece di esistere solo nella dashboard. Chi può fare cosa lo decidono le policy di Row Level Security, le funzioni Postgres e le server route di Nitro; il client non controlla niente. Le tessere hanno uno storico, e lo stato di ogni associato lo calcola una vista dalla data dell'ultimo rinnovo, senza un flag booleano da tenere aggiornato.
Su Vercel invece mi sbagliavo: il blog e l'app girano entrambi su Cloudflare Workers, e il blog è un Worker che serve solo file statici.
Anche l'editor è cambiato. Avevo previsto Nuxt Studio, ma l'ho tolto: segnalava un conflitto permanente sui contenuti che passano dai miei moduli di trasformazione, perché con la pipeline che ho costruito il file su GitHub e la pagina pubblicata non coincidono mai. Adesso il piano è un editor su misura basato su TipTap, che però non ho ancora scritto.
I pagamenti online, che pensavo di aggiungere in una seconda fase, non ci saranno. Un gestore di pagamenti trattiene una percentuale su ogni transazione e l'associazione non vuole pagarla, quindi gli incassi li registra un admin e la tessera si rinnova da lì.
Poi ci sono le cose che nel piano non c'erano proprio, e che racconto nell'articolo su Upkeep, il gestionale dei tornei: un bot Telegram con una Mini App, il timer dei round, le classifiche pubbliche, i redirect dai vecchi sottodomini, uno strumento per normalizzare le liste dei mazzi. Sono nate da come l'associazione lavora davvero, ma nessuno me le aveva chieste, e il rischio di allargarsi troppo c'è.
Mancano ancora i test end-to-end dei flussi con l'accesso, che richiedono Supabase in locale, e un account leggero per chi gioca senza essere socio, che per ora esiste solo come design scritto.
TODO.md e nelle issue su GitHub. A memoria avrei dovuto ricostruire tutto.Le scelte che hanno retto sono quelle fatte presto e su poche cose: il database come fonte dei permessi e la logica di dominio fuori dall'interfaccia. Hosting, editor e perimetro li avevo lasciati aperti, e sono cambiati. Se potessi scrivere a me stesso di settembre 2025, mi direi di mettere subito per iscritto dove voglio arrivare e di tenere la lista corta.
Da Altervista a blog.pauperwave.org
Dal 2019 il blog viveva su newpauperwave.altervista.org: un WordPress gratuito su Altervista, con 675 post tra decklist, report dei tornei, recensioni dei set e articoli sul Pauper, il formato di Magic: The Gathering in cui si gioca solo con carte comuni. Oggi lo stesso archivio è su blog.pauperwave.org, un sito Nuxt con Nuxt Content e Nuxt UI generato in modo statico.
Le categorie
Su WordPress i contenuti erano divisi in categorie: Decklists, Report, Articles, Spoiler, Deck Guides, Data ed Eventi. Nel nuovo blog sono diventate cinque collezioni di Nuxt Content con lo stesso schema di base (titolo, data, descrizione, tag, autore, copertina):
| Su WordPress | Nel nuovo blog |
|---|---|
| Decklists | Decklist |
| Report | Report |
| Articles | Articoli |
| Spoiler | Spoiler |
| Deck Guides | Tutorial |
| Data | Articoli, con i grafici |
Eventi aveva solo due post, degli annunci, che sto smistando a mano uno per uno.
Il criterio è la forma del contenuto: una decklist ha sempre un mazzo, un report ha i turni di un torneo, uno spoiler ha i voti alle carte di un set in uscita. L'argomento lo dicono i tag, come Top 8 (i primi otto di un torneo), League, Paupergeddon (un grande torneo Pauper italiano) o Set Review. Per questo "Data" è confluita negli articoli: erano articoli con dei grafici, e la forma era la stessa. "Deck Guides" è diventato "Tutorial", perché quei post spiegano come si gioca un mazzo, oltre a elencarne le carte.
Sul vecchio dominio pauperwave.com gli indirizzi delle categorie di WordPress portano ancora alla lista giusta, con un redirect permanente:
/category/decklists https://blog.pauperwave.org/articles?category=decklist 301
/category/report https://blog.pauperwave.org/articles?category=report 301
/category/deckguide https://blog.pauperwave.org/articles?category=tutorial 301
Chi scrive usa il markdown
Su WordPress ogni mazzo era una tabella HTML generata da un plugin, con il nome del giocatore e il piazzamento mescolati in un titolo di testo libero. Per correggere una carta bisognava cercarla in mezzo ai tag.
Adesso un autore scrive un file markdown, e un mazzo è testo semplice: quantità e nome, divisi per sezione.
::magic-decklist
---
name: Elves
player: Lahiri Cristofori
placement: Winner
headerGradient: monogreen
---
Creatures
4 Elvish Mystic
Lands
8 Forest
Sideboard
3 Scattershot Archer
::
Dietro ci sono tre moduli Nuxt scritti apposta. All'hook content:file:beforeParse, prima che Nuxt Content legga il file, riscrivono il testo in memoria: cercano ogni carta in un database SQLite costruito dai dati di Scryfall e passano al componente immagini, costo e tipo. Su git resta il file scritto a mano, che si legge bene nei diff e non dipende da un'istantanea dei dati di Scryfall.
Funziona così anche per il resto: [[Lightning Bolt]] diventa il nome della carta con l'anteprima, ::magic-cards mostra una o più carte intere, ::magic-sideboard-guide elenca cosa entra e cosa esce contro un mazzo. Ci sono anche i simboli di mana, i voti degli spoiler, i grafici e le gallerie. Ogni componente ha un esempio da copiare nella pagina dei componenti, scritta per gli autori più che per chi programma.
L'anteprima delle carte senza rubare spazio
Sul vecchio blog bastava passare il mouse sul nome di una carta per vederla, grazie a un plugin di tooltip, e volevo tenere quell'effetto. Affiancare al testo le immagini delle carte invece no: in un articolo pieno di nomi avrebbero allungato la pagina e spezzato la lettura.
Così il nome della carta resta una parola nel testo. Al passaggio del mouse compare solo l'immagine, senza bordo né freccia, a destra del puntatore, e lo segue mentre si muove:
<UTooltip
:disabled="isMobile"
:arrow="false"
:delay-duration="100"
:reference="reference"
:content="{
align: 'start',
side: 'right',
sideOffset: 10,
updatePositionStrategy: 'always'
}"
:ui="{ content: 'bg-transparent border-0 shadow-none p-0' }"
>
reference è un punto virtuale che si aggiorna a ogni movimento del puntatore, e updatePositionStrategy: 'always' fa ricalcolare la posizione del tooltip a ogni fotogramma: la carta compare vicino a dove stai guardando e lascia libero il paragrafo successivo. Da telefono il passaggio del mouse non c'è, quindi il nome è sottolineato e un tocco apre la carta a schermo intero, con un pulsante per girarla se ha due facce.
Il pulsante per girarla l'avevo provato anche da computer, ma il tooltip si chiude a ogni clic al suo interno. L'alternativa era un popover che si apre al passaggio del mouse, e non mi convinceva. Alla fine da computer si vede solo il fronte, da telefono anche il retro.
Scrivere un mazzo deve essere veloce
Il markdown è comodo, ma una lista di 75 carte (60 di mazzo più le 15 di riserva, il sideboard) va comunque scritta, e nessuno la scrive a mano: la si copia da Magic Online o da Arena, le versioni digitali del gioco, o da un sito di mazzi, ognuno con il suo formato e i suoi refusi. Per questo ho fatto il Deck Normalizer.
Si incolla la lista così com'è e lui:
- riconosce sia
4 Lightning Boltsia4x Lightning Bolt, e la riga che separa il sideboard; - corregge i nomi sbagliati con una ricerca approssimata:
Quirion Randiventa Quirion Ranger eLlanowar Elfsdiventa Llanowar Elves, ma ogni suggerimento va confermato; - controlla che il mazzo sia legale in Pauper: ogni carta stampata come comune e non bandita, almeno 60 carte, al massimo 15 di sideboard, al massimo 4 copie per carta, terre base escluse;
- divide le carte per tipo, ordina le terre e sceglie il colore dell'intestazione dai colori del mazzo;
- restituisce il blocco
::magic-decklistpronto da copiare nell'articolo.
Gira tutto nel browser. L'indice di circa 11.000 carte è un file JSON di meno di 1 MB generato durante la build, e all'API di Scryfall vanno solo i nomi che non trova. All'inizio era un'applicazione a parte, con un server e un database da 20 MB; adesso è una pagina del blog, che così resta un sito statico.
Il design segue il calendario
Se apri il blog in due giorni diversi, la home potrebbe non essere la stessa. Il sito ha 20 temi: 16 legati a feste e ricorrenze (Capodanno, Carnevale, Pasqua, il 25 aprile, Ferragosto, Halloween, Natale…) e 4 stagioni per il resto dell'anno. Ogni tema cambia i colori principali, la tinta dello sfondo scuro e l'illustrazione in home, sempre con il nome dell'artista. Dentro lo stesso tema l'illustrazione cambia ogni giorno: l'indice è il giorno dell'anno modulo il numero di illustrazioni.
Il sito è statico, quindi l'HTML generato è identico tutti i giorni. Il tema lo sceglie il browser, con un piccolo script nell'<head> che imposta data-theme prima che la pagina venga disegnata, così il colore giusto c'è dal primo istante e non si vede il lampo del tema di default. Le date di Carnevale e Pasqua cambiano ogni anno e le calcolo con l'algoritmo di Meeus. La pagina del design mostra il calendario completo e permette di provare ogni tema, qualunque sia la data.
Perché pauperwave.com è rimasto
Il blog adesso sta su blog.pauperwave.org, e pauperwave.org è il sito dell'associazione. Il dominio pauperwave.com l'ho tenuto lo stesso, anche se il .com di solito si associa a un'attività commerciale e Pauperwave non lo è: ha anni di link e di risultati nei motori di ricerca, e lasciarlo scadere voleva dire ripartire da zero con il posizionamento.
Oggi pauperwave.com non serve pagine. Un Worker di Cloudflare risponde con un redirect permanente verso blog.pauperwave.org mantenendo il percorso, e il 301 dice ai motori di ricerca che il contenuto si è spostato per sempre. Le vecchie pagine delle categorie finiscono sulla lista filtrata corrispondente, come nel file di redirect qui sopra.
A che punto è
Il nuovo blog ha 389 decklist, 173 articoli, 107 report, 27 spoiler e 26 tutorial. La maggior parte viene dall'archivio di WordPress, importata con degli script dall'API REST pubblica e marcata con il tag Archive. Restano da sistemare a mano le foto dei vecchi articoli e i link tra un post e l'altro, e da ricontrollare i dati dei grafici che ho trascritto a mano dalle immagini. Il vecchio sito su Altervista è ancora online, come riferimento.