Paperjoy è una skill per Claude Code che trasforma una riga di testo in un libro pop-up di carta: un solo file HTML che si apre, si sfoglia e ha qualcosa da toccare in ogni pagina. Scrivi «un libro pop-up di Napoli, con il Vesuvio e il golfo» e Claude salva un file .html nella cartella in cui lavori, da aprire con un doppio clic. Claude non scrive codice di disegno. Descrive la scena in un JSON, cioè cosa si alza dalla pagina, cosa è dipinto e cosa si tocca, e un motore fisso in WebGL2 la disegna. Prima della consegna un validatore apre e chiude il libro e prova ogni piega come su carta vera. Se un pezzo sporge dal libro chiuso o ne urta un altro, dice quale e di quanti millimetri. Il codice è open source, con licenza MIT.
Sfoglia gli otto libri d’esempio · Codice su GitHub
Perché la scena è un JSON e non codice?
Se il modello scrivesse anche il codice che disegna, ogni libro sarebbe un programma nuovo da controllare. Con la scena in JSON a Claude resta la scelta di cosa mettere in pagina, e la geometria la gestisce un motore che si comporta sempre allo stesso modo. È questo che permette al validatore di misurare ogni piega: lavora su dati con un formato fisso, non su codice libero.
Quali meccanismi ci sono?
Sei, presi dai libri pop-up veri.
| Meccanismo | Cosa fa |
|---|---|
| Facciata | piega parallela alla costola: palazzi, ponti, file di case |
| Gradoni | pieghe annidate che scendono verso chi legge: terrazze, scalinate |
| Torre | piega a V sulla costola: campanili, fari, la Mole |
| Linguetta | si tira dal bordo e qualcosa attraversa la pagina |
| Sportello | si alza e mostra cosa c’è sotto o dentro |
| Ruota | si gira e cambia la scena: l’ora, la stagione, il giorno e la notte |
Che cosa c’è negli otto libri d’esempio?
Roma, Venezia, Firenze, Genova, Torino, Parigi, Londra e Tokio. A Roma l’arena del Colosseo si scoperchia e una Vespa passa davanti a Trevi. A Genova una nave entra in porto sotto la Lanterna. A Firenze si guarda dentro la cupola del Duomo. A Tokio Shibuya si accende di sera. Sono esempi: per un altro luogo si cambia la descrizione, non il codice. Vale per città, borghi, hotel, negozi ed eventi. Il libro esce come pagina intera oppure come blocco da incollare in una pagina esistente, che prende la larghezza del contenitore.
Come si installa?
Servono Claude Code e Node.js. Dal Terminale:
git clone https://github.com/paolobortolotti/paperjoy ~/.claude/skills/popup-cartaPoi si riavvia Claude Code, che legge le skill all’avvio, e si chiede un libro a parole o con /popup-carta. Senza git si scarica lo zip dal repository e si sposta la cartella in ~/.claude/skills/popup-carta. Per aggiornare: git -C ~/.claude/skills/popup-carta pull.
Che cosa succede sul computer?
È tutto testo in chiaro, senza dipendenze da installare. All’installazione non parte niente. I libri girano nel browser, con motore e font dentro il file: nessuna richiesta esterna e nessun tracciamento. Il codice è con licenza MIT, i font Bebas Neue e DM Sans con licenza SIL Open Font License 1.1. I libri che crei sono tuoi.