Crear un proyecto desde una plantilla

El comando solidiom create genera un nuevo proyecto desde una plantilla, con configuraciones de Solidiom ya integradas. Es la forma más rápida de comenzar a usar primitivos de Solidiom en un nuevo proyecto.

#Uso interactivo

solidiom create

La CLI solicitará de forma interactiva:

1. Plantilla a utilizar
2. Nombre del proyecto
3. Perfil de estilo

#Uso no interactivo

Para saltar los prompts, pasa todos los valores necesarios como banderas y usa --yes:

solidiom create my-app --template vite-solid-router --yes

La bandera --yes exige que todos los valores requeridos estén presentes. Si falta alguno, el comando falla explícitamente.

#Plantillas disponibles

Las plantillas incluyen configuraciones predefinidas con frameworks específicos:

Para usar una plantilla específica:

solidiom create my-app --template vite-solid-router --yes

Cada plantilla incluye primitivos base preconfigurados y un perfil de estilo predeterminado.

#Perfil de estilo

Selecciona el perfil de estilo del proyecto:

solidiom create my-app --template vite-solid-router --styling tailwind --yes
solidiom create my-app --template vite-solid-router --styling css --yes
solidiom create my-app --template vite-solid-router --styling unocss --yes

Los valores válidos son css, tailwind, y unocss.

#Gestor de paquetes

Puedes especificar el gestor de paquetes para la instalación de dependencias:

solidiom create my-app --template vite-solid-router --package-manager pnpm --yes

Si no se especifica, la CLI detecta automáticamente el gestor del entorno actual.

#Saltar la instalación de dependencias

Por defecto, solidiom create ejecuta la instalación de dependencias después de generar los archivos. Para omitir este paso:

solidiom create my-app --template vite-solid-router --yes --no-install

#Directorios no vacíos

Si el directorio de destino ya existe y no está vacío, la CLI se bloquea. Usa --force para sobrescribir:

solidiom create my-app --template vite-solid-router --yes --force

#Validaciones de seguridad

solidiom create aplica varias verificaciones de seguridad en el directorio de destino:

• El destino no puede escapar del directorio de trabajo actual
• El destino no puede ser el directorio home del usuario
• El destino no puede ser la raíz del sistema de archivos
• El destino no puede ser la raíz de un monorepo existente

Estas protecciones son intencionales y no se pueden desactivar con --force.

#Nombre del proyecto

El nombre del proyecto (pasado con --name o como argumento posicional) debe cumplir con las reglas de nomenclatura de paquetes npm:

• Minúsculas
• Solo caracteres [a-z0-9-._~]
• No puede comenzar con ”.” o ”_”
• Máximo 214 caracteres
• Soporta nombres con ámbito (@scope/name): @mi-org/mi-app

#Limpieza tras cancelación

Si cancelas el proceso interactivo con Ctrl+C, la CLI limpia cualquier archivo generado, sin dejar rastros en el disco.

#Configuración generada

Después de crear el proyecto, se genera automáticamente .solidiom/config.json con:

• stylingProfile configurado según tu selección
• Rutas de instalación según los valores predeterminados
• El modo de instalación predeterminado

#Salida JSON

solidiom create my-app --template vite-solid-router --yes --json

#Opciones