create-unaxt

CLI interna para generar y configurar proyectos con Nuxt de forma rápida y estandarizada dentro del equipo.

Características

• Soporte para plantillas privadas: autenticación mediante token de GitHub
• Múltiples gestores de paquetes: npm, pnpm, yarn, bun y deno
• Interfaz interactiva: prompts claros para configurar el proyecto
• Instalación automática: instala dependencias sin pasos adicionales
• Inicialización Git: opción de crear el repositorio automáticamente
• Configuración persistente: almacenamiento seguro del token para futuras ejecuciones

Uso

Crear un nuevo proyecto

npx create-unaxt
# o
pnpm create unaxt

Ejemplos

# Crear en un directorio específico
pnpm create unaxt unaxt-app

# Usar una plantilla específica
pnpm create unaxt unaxt-app --template v4

Plantillas disponibles

| Plantilla | Descripción | | --------- | ------------------------ | | v3 | Proyecto base con Nuxt 3 | | v4 | Proyecto base con Nuxt 4 |

⚙️ Opciones de CLI

| Opción | Alias | Descripción | Por defecto | | ------------------ | ----- | ----------------------------------------------- | ----------------------------- | | --cwd | - | Define el directorio de trabajo | . | | --template | -t | Especifica la plantilla a utilizar | v4 | | --force | -f | Sobrescribe el directorio existente | false | | --install | - | Instalar dependencias | true | | --no-install | - | Omitir instalación de dependencias | - | | --gitInit | - | Inicializa repositorio Git | Prompt | | --packageManager | - | Gestor de paquetes (npm, pnpm, yarn, bun, deno) | Prompt | | --offline | - | Fuerza modo sin conexión | false | | --preferOffline | - | Prefiere el modo sin conexión | false | | --shell | - | Abre terminal en el nuevo proyecto | false | | --configFile | - | Archivo de configuración personalizado | ~/.create-unaxt-config.json |

🔐 Configuración del Token

Para acceder a plantillas privadas, se necesita un token de GitHub con permisos de lectura sobre el repositorio de las plantillas.

El CLI solicitará el token durante la primera ejecución y, si el usuario lo autoriza, lo almacenará en ~/.create-unaxt-config.json para reutilizarlo en futuras ejecuciones.

🛠️ Desarrollo

Instalar dependencias

pnpm install

Compilar el proyecto

pnpm build

Probar la herramienta localmente

pnpm create-unaxt

Publicar un nueva versión

pnpm release:patch

📁 Estructura del proyecto

create-unaxt/
├── bin/
│   └── create-unaxt.mjs       # Punto de entrada del CLI
├── src/
│   ├── commands/
│   │   └── init.ts            # Comando principal de inicialización
│   ├── utils/
│   │   ├── banner.ts          # Banner ASCII
│   │   ├── console.ts         # Utilidades de consola
│   │   └── logger.ts          # Logger personalizado
│   ├── index.ts               # Exportaciones principales
│   ├── main.ts                # Configuración del CLI
│   └── run.ts                 # Ejecutor de comandos
├── package.json
└── build.config.ts            # Configuración de compilación (unbuild)

Créditos

Este proyecto se basa en las mejores prácticas de los starters oficiales de Nuxt y Nitro:

• nitrojs/create-nitro-app
• nuxt/create-nuxt

Herramientas utilizadas:

• consola - Logger para Node.js
• citty - Framework para CLIs
• giget - Descarga de plantillas
• nypm - Gestión unificada de paquetes