Da una raccolta di giochi a un prodotto
PuzzleHub nasce per riunire puzzle di logica, numeri, percorsi, ombreggiatura e strategia in un unico luogo. L'ambizione non è riempire una pagina di link. Vogliamo che scoprire un gioco, impararne le regole, iniziare una partita, salvare i progressi e confrontare i risultati sia naturale qualunque sia il puzzle scelto.
Questo cambia completamente il problema tecnico. Ogni gioco ha regole e rappresentazioni proprie, ma intorno a tutti ricompaiono esigenze comuni: navigazione, controlli, difficoltà, dimensioni della griglia, nuova partita, aiuto, statistiche, accessibilità e adattamento al mobile.
Una base volutamente semplice
La prima architettura si basa su HTML, CSS e JavaScript statici, generazione tramite script e distribuzione con Firebase Hosting. GitHub resta il centro del codice, delle revisioni e dell'automazione. È una base poco spettacolare, ma veloce, economica da servire e semplice da ispezionare.
Fin dall'inizio documentiamo obiettivo, architettura e convenzioni del repository. L'intenzione è importante: l'IA può accelerare enormemente lo sviluppo, ma solo se gli agenti ricevono limiti, contesto e criteri di qualità chiari.
Il catalogo sarà un problema di design
Sappiamo che il numero di giochi crescerà rapidamente. Per questo il catalogo non può dipendere da un elenco scritto a mano né da una home progettata per dieci elementi. I metadati di ogni gioco vivono separati dall'interfaccia per poter generare pagine, categorie e navigazione in modo sistematico.
Costruire in pubblico significa anche mostrare il processo
Questo Journal non sarà soltanto un changelog. Racconteremo decisioni tecniche, esperimenti falliti, algoritmi di generazione, strumenti di IA, automazione, design, prestazioni e come cambia il nostro modo di lavorare mentre il progetto cresce.
La prima versione di PuzzleHub non vuole essere la destinazione finale. È la griglia sulla quale giocheremo la nostra stessa partita di sviluppo.