Vai al contenuto
Verificata

Scegliere tra Slim e la CLI

La domanda sulla fonte di verità che decide da quale percorso di scrittura partire, e come passare dall'uno all'altro.

Il modo migliore per scegliere è chiedersi chi possiede la fonte di verità: una pagina o un progetto.

Scegli Slim quando

  • la pagina è piccola o incorporata
  • l'HTML è la superficie di scrittura naturale
  • l'albero del runtime viene generato direttamente
  • vuoi un punto di ingresso leggero
  • stai creando documentazione, demo o una superficie di marketing interattiva

Scegli la CLI quando

  • stai creando un'app completa da file sorgente
  • vuoi una struttura di progetto canonica
  • le unità di logica come get_data, set_data, batch, api e alert devono stare in cartelle dedicate
  • tabelle, route e agenti AI richiedono risorse esplicite
  • la sincronizzazione e i documenti di runtime generati devono essere gestiti al posto tuo

Un percorso di migrazione pratico

Molti team iniziano con Slim e passano alla CLI più tardi, e questo percorso funziona perché i concetti del runtime non cambiano sotto: le espressioni sui campi usano ancora @field_name, i programmi si compilano ancora nello stesso modello di documento, e i tag strutturali e i pannelli contano ancora. Nulla di ciò che impari in modalità Slim va sprecato quando un progetto la supera.

Una semplice regola pratica

Se la pagina somiglia a un documento o a un widget incorporato, parti da Slim. Se il progetto somiglia a un'applicazione, parti dalla CLI.

Errori del primo giorno da evitare

  • prog_id sbagliato. Se non corrisponde a un programma che Slim riesce a trovare, viene caricata la cosa sbagliata o non viene mostrato nulla.
  • Aspettarsi un modello mentale diverso. Slim è più leggero da avviare, ma segue comunque i concetti del runtime Xuda in tutto.
  • Dare per scontato che la conversione automatica dell'HTML funzioni fuori da <template>. Il percorso automatico verificato da HTML a progUi è guidato dai template; affidati ai tag <template id="..."> per quella conversione.
  • Valori di attributo simili a JSON malformati. Un attributo che sembra un oggetto o un array ma non è JSON valido resta una semplice stringa invece di diventare dati strutturati.
  • Scegliere un lavoro da CLI e chiamarlo lavoro da Slim. Se il progetto vuole routing, una struttura di app più grande e un'organizzazione dei sorgenti di lunga durata, la CLI è il punto di partenza migliore.