Web app 3D installabile (PWA) · 2026
Cubo magico — gioco 3D nel browser
Il Cubo magico di gianlucaiunco.com è un cubo di Rubik in 3D che si usa nel browser, da PC o dal telefono, e si installa come app anche senza passare dagli store. L'ho sviluppato nell'ottobre 2026 con Three.js e l'assistenza di Claude Code, insieme a otto lezioni sul metodo a strati con un cubo interattivo per ogni caso. Funziona anche senza rete e salva tempi e partite solo nel browser di chi gioca.
Contesto
Il cubo magico, cioè il cubo di Rubik, è il primo gioco della sezione Giochi del sito, aperta nell'ottobre 2026. È un progetto mio: l'ho ideato e sviluppato con l'assistenza di Claude Code, mentre le scelte, la verifica delle lezioni e le prove su telefoni e browser diversi sono mie. Lo uso anche come banco di prova per tecniche che si possono riusare nei siti dei clienti: grafica 3D nel browser, app installabili, video generati dal codice.
Obiettivo
Volevo un cubo che si giri come quello vero, con il mouse o con il dito, e che dica in quanto tempo e con quante mosse lo hai risolto. Non dovevano servire account, database o librerie pesanti oltre a Three.js, e la pagina doveva restare comoda anche su uno schermo piccolo.
Cosa ho fatto
Come si gioca?
Si trascina un pezzo per girare il suo strato: lo strato segue il dito e al rilascio va al quarto di giro più vicino. Trascinando fuori dal cubo si cambia vista. Da tastiera ci sono le lettere della notazione (R, L, U, D, F, B e le altre), con Maiusc per il senso antiorario e Ctrl+Z per annullare. "Mescola" fa 22 mosse, il tempo parte alla prima mossa e la pausa ferma il tempo e nasconde il cubo, così non si può studiare la posizione a orologio fermo. Record e media delle ultime cinque partite restano nel browser, senza cookie.
Come funziona sul telefono?
Sul telefono si gioca a schermo intero, e il cubo si installa come app che funziona anche senza rete. Nella pagina, al posto del cubo, c'è un riquadro con il disegno del cubo, il record e il bottone "Inizia partita"; uscendo dallo schermo intero la partita va in pausa e si riprende dallo stesso punto. L'app si installa su Android dal bottone "Installa l'app" e su iPhone dal menu Condividi; un service worker tiene una copia della pagina e dei file per giocare offline.
Cosa insegnano le lezioni?
Le otto lezioni spiegano il metodo a strati, dalla notazione agli ultimi angoli gialli, in italiano e in inglese. Ogni caso ha il suo cubo: riproduce la sequenza una mossa alla volta, avanti e indietro, lascia grigi i pezzi che in quel momento non contano e riconosce quando l'obiettivo è raggiunto, anche se il cubo lo giri a mano.
Come nascono i video per i social?
Dal pannello del sito genero video MP4 per post, feed e storie, in chiaro o in scuro, in italiano o in inglese. Il cubo esegue una sequenza scelta dal codice che, ripetuta tre o quattro volte, lo riporta alla posizione di partenza, così il video si ripete senza stacchi. Anche l'immagine che compare quando si condivide il link è generata dal server.
La parte più difficile
- Le lezioni dovevano essere giuste. Ogni caso parte dal cubo risolto e applica la sequenza al contrario, quindi il testo deve descrivere esattamente quella posizione. Ho scritto una pagina di prova che usa lo stesso motore del gioco e controlla dove finisce ogni pezzo: ha trovato una frase sbagliata in una lezione, corretta prima della pubblicazione.
- Il video ripartiva con uno scatto. Registrare lo schermo dal vivo lasciava un fotogramma doppio tra la fine e l'inizio. Ora il video si costruisce fotogramma per fotogramma con WebCodecs, a 30 fotogrammi al secondo esatti, e l'ultimo si ferma un passo prima del primo.
- Lo schermo intero sul telefono. L'interfaccia a schermo intero dei browser si comporta in modo diverso tra Android e iPhone, quindi il gioco occupa la finestra con il CSS e il tasto Indietro del telefono lo chiude come farebbe con una pagina.
- L'app fuori dalla sua cartella. La pagina del gioco e il service worker hanno indirizzi diversi: il server dichiara con un header che il worker può controllare la pagina del gioco, e solo quella.
Risultato
Il gioco e le lezioni sono online su /giochi/cubo-magico e il cubo si installa come app sul telefono. Se ti serve un'app che i tuoi clienti possano installare dal sito, anche offline e senza pubblicarla sugli store, trovi cosa posso fare nella pagina servizi.