Blog

2026-11-11

UluP Nexus: dalla candidatura alla mappa, adesso funziona davvero

Fino a pochi giorni fa, quando parlavo di UluP Nexus, parlavo soprattutto della mappa. Un posto dove trovare piccoli software e giochi indipendenti, con ogni progetto collegato alla sua categoria. E, dall'altra parte, un server MCP che permette anche agli assistenti AI di cercare nello stesso indice.

La mappa funzionava già. Il server MCP anche. Ma mancava una parte importante: cosa succede quando un altro sviluppatore vuole entrarci?

Non volevo che la risposta fosse «scrivimi e aggiungo io tutto a mano nel database». Volevo un percorso vero, dall'inizio alla fine.

In questi giorni ho lavorato proprio a questo. E l'ho provato su Nexus online, non solo sul mio computer.

Il primo problema: un dominio non è un progetto

La prima cosa da sistemare era meno vistosa di un pulsante, ma fondamentale.

Se qualcuno inserisce `github.com/utente/progetto-a` e un altro inserisce `github.com/utente/progetto-b`, sono due progetti diversi. Eppure condividono il dominio `github.com`.

Ho cambiato la logica dei duplicati perché consideri l'URL completo, non il solo dominio. Sembra un dettaglio, finché non provi ad aprire un indice agli sviluppatori che distribuiscono il loro lavoro su GitHub o su altre piattaforme condivise.

Ho anche rivisto la lettura degli URL. Quando un server legge una pagina indicata da un utente, bisogna controllare dove sta davvero cercando di collegarsi: indirizzi privati, DNS, redirect, porte e limiti di risposta non sono dettagli da ignorare. Ho aggiunto protezioni, anche se i test di sicurezza più approfonditi restano una delle prossime cose da fare.

Dimostrare che il progetto è tuo

Adesso una candidatura viene salvata come `pending`: è arrivata, ma non è ancora pubblicata.

Poi viene la verifica della proprietà. Per un repository GitHub, Nexus genera una riga simile a questa:

```text ulup-nexus-verify: <token> ```

Il maker la inserisce nel README del repository. Nexus controlla la presenza del token attraverso GitHub e, se lo trova, registra la proprietà come verificata.

Per i siti indipendenti c'è anche il percorso con il meta tag HTML; per alcune piattaforme condivise è prevista la revisione manuale delle prove inviate. Il percorso GitHub è quello che abbiamo collaudato dall'inizio alla fine. Gli altri meritano ancora test specifici.

C'è una distinzione alla quale tengo: dimostrare di possedere un progetto non significa essere pubblicati automaticamente. La verifica di proprietà e la decisione editoriale sono due cose diverse.

Il pannello che prima non c'era

La novità più grande, per me, è `/admin`.

Ho costruito un pannello privato dove posso vedere le candidature in attesa, aprire i link, controllare la verifica, leggere le prove inviate e scegliere se approvare o rifiutare un progetto. In caso di rifiuto posso salvarne il motivo, senza dover cancellare la scheda per forza.

Dietro non c'è soltanto una pagina con una password. L'accesso passa da Supabase Auth, mentre le API controllano sul server che l'utente autenticato sia proprio l'amministratore autorizzato. Le credenziali privilegiate del database restano sul server, non nel browser.

Ho provato ad aprire le API senza autenticazione: HTTP 403. Ho provato anche con un secondo account Supabase perfettamente valido ma non autorizzato: accesso negato. È il comportamento che volevo vedere.

Il momento in cui è apparso nella mappa

Per non usare un progetto vero come cavia, ho creato un piccolo repository GitHub temporaneo: `nexus-test`.

L'ho inviato tramite il form pubblico di Nexus. Il sistema ha salvato l'indirizzo completo, generato il token, verificato la proprietà attraverso il README e lasciato la candidatura in attesa.

Sono entrato nel pannello, ho premuto Approve & publish e ho aperto la homepage.

Il progetto era nella mappa.

Non l'avevo inserito manualmente su Supabase. Era arrivato dal modulo pubblico, era stato verificato ed era passato dalla moderazione. Per me, quel piccolo nodo di prova contava più di tante schermate finite.

Poi l'ho eliminato dal database: era soltanto un test.

Ho fatto anche il percorso opposto. Una seconda candidatura temporanea, questa volta rifiutata dal pannello, con un motivo registrato nel database e lo stato `rejected`. Anche quel record è stato poi rimosso.

Non è stata una giornata senza errori

Durante il lavoro Next.js 16 ha fermato la build perché alcune opzioni delle route API non erano compatibili con `cacheComponents`. Ho corretto il codice, poi rifatto lint e build.

C'era anche un avviso di *hydration mismatch* nella mappa: server e browser calcolavano due posizioni diverse per la barra di ricerca quando l'introduzione della homepage era ridotta. Ho spostato quel comportamento sul CSS, in modo che la posizione non dipendesse da due render iniziali potenzialmente differenti.

Alla fine ho unito il lavoro nel branch principale, configurato l'accesso amministrativo su Vercel e verificato il pannello pubblicato.

Racconto anche queste cose perché, quando si costruisce da soli, il progresso non è una successione di funzioni che appaiono magicamente. Spesso è una serie di problemi piccoli, test, correzioni e nuovi test.

Cosa funziona oggi e cosa manca

Oggi Nexus ha:

  • una mappa pubblica, una vista a elenco e pagine per i progetti;
  • un server MCP pubblico con `search_projects` e `list_categories`;
  • un modulo di candidatura che legge i dati iniziali del sito;
  • il controllo dei duplicati sull'URL completo;
  • la verifica della proprietà GitHub tramite README, provata su una candidatura reale;
  • un pannello privato che approva o rifiuta le candidature;
  • la pubblicazione nella mappa dopo l'approvazione, provata davvero.

Le prossime cose da fare sono collaudare a fondo la verifica via meta tag e quella manuale, eseguire test di sicurezza più avanzati, migliorare i metadati letti da GitHub, aggiungere notifiche email e rendere più semplice aggiornare una scheda dopo la pubblicazione.

E manca soprattutto una cosa che non si risolve con un altro commit: i primi sviluppatori esterni che scelgano spontaneamente di aggiungere il proprio progetto.

Adesso tocca anche agli altri

Nexus non nasce per raccogliere soltanto i prodotti di UluP Studio. L'idea è dare un posto leggibile, sia dalle persone sia dagli assistenti, anche ai progetti piccoli che rischiano di perdersi fra migliaia di link.

Se stai costruendo un software, un tool o un gioco indipendente, puoi inviare il tuo progetto. La scheda non va online automaticamente: controllo le candidature prima di pubblicarle.

Puoi anche esplorare la mappa oppure collegare Nexus a un assistente tramite MCP.

Non so ancora quanti maker sceglieranno di partecipare. Ma almeno, da oggi, quando qualcuno mi chiede «come faccio a entrare nella mappa?», posso indicargli un processo che ho visto funzionare con i miei occhi.

Ed è un bel passo avanti.

Blog