Modelli di app

Scegli la forma di app più piccola che corrisponde al lavoro. Aggiungi un processo, un database, una sincronizzazione o un’API AI solo quando l’app ne ha bisogno.

L’utente vuole	Usa	Note
Pagina di destinazione, report, pagina statica	App UI	Un componente UI è sufficiente.
Dashboard o strumento interno con dati del server	UI + processo	Mantieni le route API e le credenziali nel componente processo.
Dati persistenti dell’app	UI + processo + database	Riutilizza un database attivo adatto prima di crearne uno.
Dati offline o multi-dispositivo istantaneo	App in tempo reale	Abilita la sincronizzazione e verifica `sync: ready` prima di collegare l’app.
Lavoro pianificato o webhook	App processo	Usa i trigger su un componente processo.
Funzionalità basata su AI all’interno di un’app	Processo + API AI Kazzle	Usa `/ai/*` con una chiave API `kzl_`.
Strumento che l’assistente dovrebbe chiamare in seguito	Skill + processo	Aggiungi una cartella skill (`SKILL.md` + `tools.ts`) e supporta ogni tool `target.type: 'app'` con una route su un componente processo.

Impostazioni predefinite

Inizia da un template quando è appropriato.
Mantieni il codice frontend libero da segreti e URL di database.
Metti il lavoro solo server in un componente processo.
Usa gli URL dei componenti fratelli invece di indirizzi localhost hardcoded.
Verifica le anteprime nella scheda app-dev prima di dire che l’app è in esecuzione.