> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelli di app

> Quale forma di app Kazzle usare per i lavori comuni.

# 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.