La maggior parte dei tutorial sui chatbot React si ferma a una demo. La risposta arriva tutta insieme dopo otto secondi, l’intero thread viene reinviato al modello a ogni turno e la chiave si trova in una variabile NEXT_PUBLIC_ che Next inserisce direttamente nel bundle del browser. In uno screenshot sembra tutto a posto, ma crolla nella prima settimana di utilizzo reale.
Questa è una guida alla realizzazione, non un prompt di sistema. Inserisci il file nel tuo progetto, aprilo con Claude Code o Cursor e lavora insieme allo strumento sull’architettura: streaming con il lettore Fetch ReadableStream, un AbortController collegato all’interruzione, un messaggio utente ottimistico a cui vengono aggiunti i token, un elenco che non esegue il re-render di ogni fumetto a ogni token, l’autoscroll che smette di ostacolare chi legge dopo aver fatto scorrere la pagina verso l’alto, markdown e blocchi di codice, la chiave dietro un route handler, la cronologia in localStorage e poi in un backend reale, e un budget di token per il giorno in cui il thread diventa lungo.
Lo acquisti una volta e resta tuo. Nessun abbonamento, nessuna dipendenza runtime e nulla che ti impedisca di riutilizzarlo nel prossimo progetto o di modificarlo man mano che il tuo codebase evolve.