Elegir entre Slim y la CLI
La pregunta sobre la fuente de verdad que decide con qué camino de creación empezar, y cómo pasar de uno a otro.
La mejor forma de elegir es preguntarse quién es dueño de la fuente de verdad: una página o un proyecto.
Elige Slim cuando
- la página es pequeña o está incrustada
- el HTML es la superficie de creación natural
- el árbol del runtime se genera directamente
- quieres un punto de entrada ligero
- estás creando documentación, demos o una superficie de marketing interactiva
Elige la CLI cuando
- estás creando una app completa a partir de archivos fuente
- quieres una estructura de proyecto canónica
- las unidades de lógica como
get_data,set_data,batch,apiyalertdeben vivir en carpetas dedicadas - las tablas, las rutas y los agentes de IA necesitan recursos explícitos
- quieres que se encarguen por ti la sincronización y los documentos de runtime generados
Un camino de migración práctico
Muchos equipos empiezan en Slim y pasan a la CLI más tarde, y ese camino funciona porque los conceptos del runtime no cambian por debajo: las expresiones de campo siguen usando @field_name, los programas siguen compilándose hasta el mismo modelo de documentos, y las etiquetas estructurales y los paneles siguen importando. Nada de lo que aprendes en el modo Slim se desperdicia cuando un proyecto lo supera.
Una regla general sencilla
Si la página se parece a un documento o a un widget incrustado, empieza con Slim. Si el proyecto se parece a una aplicación, empieza con la CLI.
Errores del primer día que conviene evitar
prog_idequivocado. Si no coincide con un programa que Slim pueda encontrar, se carga lo que no es o no se renderiza nada.- Esperar un modelo mental distinto. Slim es más ligero para empezar, pero sigue los conceptos del runtime de Xuda en todo momento.
- Suponer que la conversión automática de HTML funciona fuera de
<template>. El camino automático verificado de HTML aprogUiestá guiado por plantillas; apóyate en etiquetas<template id="...">para esa conversión. - Valores de atributo tipo JSON mal formados. Un atributo que parece un objeto o array pero no es JSON válido sigue siendo una cadena simple en lugar de convertirse en datos estructurados.
- Elegir trabajo de CLI y llamarlo trabajo de Slim. Si el proyecto necesita rutas, una estructura de app mayor y una organización del código fuente de larga duración, la CLI es el mejor punto de partida.