Installare, e vedere qualcosa

Hai un progetto Next con Payload, o stai per averlo. Alla fine di questo capitolo il sistema sarà dentro, e avrai una pagina che rende.

Questa guida non è il manuale di riferimento: quello è la documentazione, e ogni volta che qui compare il nome di un oggetto lì c’è la sua voce. Qui si impara a orchestrarli.

Installa il pacchetto. Lancia lo scaffold.

Registra il plugin nella config di Payload. Avvia.

Alla radice sono comparsi sei file db.*.json: sono tuoi, non del pacchetto.

Il pacchetto è entrato da un punto solo — il plugin — e ne è uscito lasciando file che appartengono al progetto. È una distinzione che conta: quello che l’init scrive lo modifichi tu e nessun aggiornamento del pacchetto lo ritocca.

I sei file sono gli store: viewMode, stili, variabili base, temi, animazioni, eventi. Non sono configurazione del pacchetto, sono il vocabolario del tuo sito — e il motore legge quelli, non i valori di partenza che stanno dentro il pacchetto.

E l’admin è già aperto: in coda allo scaffold, se non ci sono utenti, l’init ne crea uno con ruolo ADMIN — admin@uims.local / uims-admin, ripetute nell’esito — passando dal flusso ufficiale di Payload, lo stesso della schermata «create first user». Entri subito; le credenziali le cambi dall’admin quando vuoi, e in produzione questo utente non esiste proprio. --no-first-user lo salta, e se il database non è raggiungibile in quel momento l’init lo dice e va avanti.

Salta la registrazione del plugin. Il progetto compila, parte, e non c’è niente: nessuna collection, nessun blocco, nessuno Studio.

Non è un errore silenzioso di UIMS, è che non è stato invitato. Il plugin è l’unico punto di ingresso, e senza quella riga il pacchetto è una dipendenza installata e mai chiamata.

Prima di toccare qualcosa, un giro veloce di cosa ti sei portato in casa.