Blog
Il blog di Pauperwave: sette anni di Pauper da WordPress a Nuxt
Illustrazione di copertina: Clone Crafter di Lie Setiawan
SviluppoNuxtVueProgetti personali5 nov 2026 (aggiornato il 12 nov 2026) — 9 min di lettura

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

Emanuele Nardi

Il 15 settembre 2025 ho scritto in una chat di Telegram: «Sto per creare un nuovo progetto e sono alla ricerca di consigli su come strutturarlo». Nessuno mi ha risposto, e ho iniziato comunque. 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.

Nel messaggio c'era già un piano: 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 messaggio 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 messaggio 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.

Questo confronto l'ho fatto in pochi minuti perché le pendenze erano scritte nel repository, in un 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 rispondere io a quel messaggio di settembre, mi direi di scrivere subito 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 WordPressNel nuovo blog
DecklistsDecklist
ReportReport
ArticlesArticoli
SpoilerSpoiler
Deck GuidesTutorial
DataArticoli, 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:

_redirects
/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.

decklist.md
::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:

app/components/magic/card/Tooltip.vue
<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 Bolt sia 4x Lightning Bolt, e la riga che separa il sideboard;
  • corregge i nomi sbagliati con una ricerca approssimata: Quirion Ran diventa Quirion Ranger e Llanowar Elfs diventa 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-decklist pronto 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.

build 631 • 009a823

© 2026 Emanuele Nardi