create-devanthos-app

v2.1.3

Published

16 days ago

CLI oficial para crear proyectos con las plantillas modernas Devanthos (Astro, Next.js, Expo y más) - Con sistema de plugins, actualizaciones automáticas, CLI flags, Git auto-init, presets y configuración personalizable. Versión 2.0: Plantillas locales y

🚀 create-devanthos-app

CLI oficial de Devanthos para crear proyectos modernos con Astro, Next.js y Expo

Plantillas profesionales, optimizadas y listas para producción ✨

🌟 Características

🎯 Plantillas optimizadas - Configuraciones profesionales para Astro y Next.js
🚀 Instalación rápida - Un comando para crear tu proyecto completo
📦 Gestores inteligentes - Detección automática de pnpm, yarn, bun o npm
🎨 Experiencia premium - Interfaz moderna con colores y animaciones
🔧 Configuración completa - TypeScript, Tailwind CSS, ESLint y más
📱 Responsive ready - Diseños adaptativos desde el primer día
🆕 CLI Flags - Modo interactivo o no-interactivo para automatización
🆕 Git Auto-Init - Inicialización automática de repositorio Git con commit inicial
🆕 Presets - Configuraciones predefinidas para casos de uso comunes
🆕 Config File - Guarda y reutiliza configuraciones con devanthos.config.js
✨ Sistema de Plugins v2.0 - 8 plugins modulares disponibles (Analytics, Auth, Database, Content, SEO, Stripe, Expo Auth, Mercado Pago)
🔌 Plugin Installer - Instala plugins en proyectos existentes con un comando

🚀 Uso rápido

Modo Interactivo (Wizard)

# Crear un nuevo proyecto (recomendado)
npx create-devanthos-app

# O con npm
npm create devanthos-app

# O con pnpm (recomendado)
pnpm create devanthos-app

El asistente te guiará paso a paso:

Selecciona el framework (Astro, Next.js o Expo)
Elige configuración (preset o manual)
Nombra tu proyecto
Selecciona plugins (si el preset incluye plugins, puedes elegir cuáles instalar)
Confirma instalación automática
Inicializa Git (opcional)
Guarda configuración (opcional, solo si usas preset)
¡Listo! 🎉

Modo No-Interactivo (CLI Flags) 🆕

# Crear proyecto con template
npx create-devanthos-app mi-proyecto -t astro

# Crear proyecto con preset (Nuevo!)
npx create-devanthos-app mi-blog -p blog

# Con configuración guardada
npx create-devanthos-app mi-dashboard -p dashboard --save-config

# Para CI/CD (sin prompts)
npx create-devanthos-app build-app -t next --no-git --skip-update-check

📖 Documentación completa:

CLI Flags - Guía de flags y opciones
Presets - Guía completa de presets y configuración

📦 Presets Predefinidos 🆕

Crea proyectos optimizados con configuraciones predefinidas:

# Ver presets disponibles
npx create-devanthos-app list-presets

# Usar un preset
npx create-devanthos-app mi-proyecto -p <preset-id>

Presets Disponibles

| Preset | Framework | Descripción | Incluye | | -------------- | ---------- | ----------------------- | ---------------------- | | landing-page | Astro | Landing page optimizada | Analytics, SEO, Forms | | dashboard | Next.js | Panel admin completo | Auth, Database, Charts | | blog | Astro | Blog con MDX | MDX, RSS, Sitemap | | ecommerce | Next.js | Tienda online | Stripe, Cart, Auth | | portfolio | Astro | Portfolio personal | MDX, SEO, Projects | | mobile-app | Expo | App móvil | Navigation, Auth | | minimal | Cualquiera | Configuración mínima | TypeScript básico |

Ver documentación completa: PRESETS.md

🎯 Plantillas disponibles

🌌 Astro Template

Ideal para: Sitios estáticos, landing pages, blogs, documentación

Incluye:

⚡ Astro 4.0+ con renderizado híbrido
🎨 Tailwind CSS + componentes prediseñados
📝 TypeScript configurado
🔍 SEO optimizado + Meta tags
📱 PWA ready
🌙 Modo oscuro incluido
📊 Analytics preparado

⚛️ Next.js Template

Ideal para: Aplicaciones web, dashboards, SaaS, e-commerce

Incluye:

🚀 Next.js 14 + App Router
🎨 Tailwind CSS + Shadcn/ui
📝 TypeScript estricto
🔐 Autenticación preparada
🗃️ Base de datos (Prisma + SQLite)
🧪 Testing (Jest + React Testing Library)
📊 Métricas y Analytics

📱 Expo Template

Ideal para: Aplicaciones móviles, apps nativas, MVP rápidos

Incluye:

🚀 Expo SDK 50+ con EAS Build
🎨 NativeWind (Tailwind para React Native)
📝 TypeScript configurado
🧭 Navegación (React Navigation)
🔍 Estado global (Zustand)
📷 Cámara y multimedia listos
📦 Publicación automática (EAS)

📖 Guía paso a paso

1. Ejecutar el CLI

npx create-devanthos-app

2. Seleccionar plantilla

¿Qué tipo de proyecto querés crear?
❯ 🌌 Astro - Sitios estáticos y landing pages ultra rápidas
  ⚛️ Next.js - Aplicaciones dinámicas, dashboards y SaaS
  📱 Expo - Aplicaciones móviles con React Native

3. Nombrar el proyecto

¿Cuál será el nombre de tu proyecto? mi-proyecto-devanthos

4. Confirmar instalación

¿Querés instalar las dependencias automáticamente? (Y/n)

5. ¡Proyecto creado!

cd mi-proyecto-devanthos
npm run dev

💡 Ejemplos de uso

Crear proyecto Astro para landing page

npx create-devanthos-app
# Selecciona: 🌌 Astro
# Nombre: landing-empresa
# ✅ El proyecto estará en ./landing-empresa

Crear aplicación Next.js para dashboard

npx create-devanthos-app
# Selecciona: ⚛️ Next.js
# Nombre: admin-dashboard
# ✅ El proyecto estará en ./admin-dashboard

🔧 Configuración avanzada

Variables de entorno

# Modo desarrollo (más logs)
NODE_ENV=development npx create-devanthos-app

# Desactivar actualización automática del CLI
export DEVANTHOS_NO_UPDATE_CHECK=true

# Desactivar actualización de dependencias
export DEVANTHOS_UPDATE_DEPS=false

# Habilitar auditoría de seguridad
export DEVANTHOS_AUDIT=true

# Modo verbose (mostrar detalles)
export DEVANTHOS_VERBOSE=true

Gestores de paquetes

El CLI detecta automáticamente el mejor gestor disponible:

pnpm (recomendado) - Más rápido y eficiente
yarn - Alternativa robusta
bun - El más rápido (experimental)
npm - Estándar de Node.js

🔌 Sistema de Plugins v2.0

Devanthos CLI incluye un sistema modular de plugins con 8 plugins listos para usar.

📦 Plugins Disponibles

| Plugin | Framework | Descripción | | ------------------- | -------------- | ----------------------------------- | | 📊 Analytics | Astro, Next.js | Google Analytics + Vercel Analytics | | 🔐 Auth | Next.js, Expo | NextAuth.js + Expo Authentication | | 🗄️ Database | Next.js, Astro | Prisma ORM + Schema | | 📝 Content | Astro, Next.js | MDX + Content Collections | | 🔍 SEO | Astro, Next.js | Meta tags + Sitemap + robots.txt | | 💳 Stripe | Next.js | Stripe Checkout + Webhooks | | 📱 Expo Auth | Expo | AuthContext + Login Screens | | 💰 Mercado Pago | Next.js | Pagos LATAM (8 países) |

🚀 Instalar Plugins

Modo Interactivo:

cd mi-proyecto
npx devanthos-plugins install

Modo CLI:

# Instalar plugin específico
npx devanthos-plugins install @devanthos/plugin-stripe

# Especificar framework
npx devanthos-plugins install @devanthos/plugin-analytics --framework next

# Saltar dependencias
npx devanthos-plugins install @devanthos/plugin-auth --skip-deps

Listar plugins:

# Todos los plugins
npx devanthos-plugins list

# Por framework
npx devanthos-plugins list --framework next
npx devanthos-plugins list --framework astro
npx devanthos-plugins list --framework expo

✨ Características del Sistema

✅ Estructura modular - Plugins autocontenidos con plugin.json
✅ Auto-instalación - Copia archivos e instala dependencias automáticamente
✅ Multi-framework - Soporte para Next.js, Astro y Expo
✅ Documentación integrada - Cada plugin incluye docs completas
✅ TypeScript - Completamente tipado
✅ Compatibilidad - Funciona con plugins legacy (.plugin.js)

📚 Documentación completa: plugins/README_PLUGIN_SYSTEM.md

Crear tu Propio Plugin

Estructura básica:

plugins/
└── mi-plugin/
    ├── plugin.json          # Metadata
    ├── MI-PLUGIN.md         # Documentación
    └── src/                 # Código fuente
        ├── components/
        ├── lib/
        └── ...

plugin.json:

{
    "name": "@devanthos/plugin-mi-plugin",
    "version": "1.0.0",
    "description": "Mi plugin",
    "frameworks": ["next"],
    "dependencies": {
        "next": {
            "mi-dependencia": "^1.0.0"
        }
    },
    "files": [
        {
            "source": "src/components/MiComponente.tsx",
            "destination": "components/MiComponente.tsx"
        }
    ]
}

🤖 Actualizaciones Automáticas

El CLI chequea automáticamente cada 24 horas si hay una nueva versión disponible.

Características

✅ Chequeo automático no bloqueante
✅ Caché inteligente (evita saturar npm)
✅ Detección de método de instalación
✅ Mensajes personalizados según instalación

Desactivar chequeos

export DEVANTHOS_NO_UPDATE_CHECK=true
npx create-devanthos-app

Actualizar manualmente

Si instalaste globalmente:

npm install -g create-devanthos-app@latest

Si usas npx:

npx create-devanthos-app@latest
# Ya siempre usa la última versión

�🛠️ Desarrollo y contribución

Clonar el repositorio

git clone https://github.com/devanthos/create-devanthos-app.git
cd create-devanthos-app
npm install

Probar localmente

npm run dev
# o
npm test

Estructura del proyecto

create-devanthos-app/
├── index.js           # CLI principal
├── utils/
│   ├── clone.js       # Lógica de clonado
│   └── install.js     # Instalación de dependencias
├── package.json       # Configuración del paquete
└── README.md         # Esta documentación

Contribuir

Fork del repositorio
Crea una branch: git checkout -b feature/nueva-funcionalidad
Commit: git commit -m 'feat: nueva funcionalidad'
Push: git push origin feature/nueva-funcionalidad
Abre un Pull Request

🆘 Troubleshooting

Error: "Framework no soportado"

# Verifica que seleccionaste 'astro' o 'next'
# Si persiste, actualiza el CLI:
npm install -g create-devanthos-app@latest

Error de permisos

# En Windows (PowerShell como administrador):
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

# En macOS/Linux:
sudo npm cache clean --force

Instalación de dependencias falla

# Instalación manual:
cd tu-proyecto
rm -rf node_modules package-lock.json
npm install

Proyecto no se crea

# Verifica conexión a internet
# Intenta con --verbose para más detalles:
npx create-devanthos-app --verbose

📚 Recursos adicionales

🌐 Documentación: docs.devanthos.com
💬 Discord: discord.gg/devanthos
🐛 Issues: GitHub Issues
📧 Email: [email protected]

🎨 Próximas funcionalidades

[ ] 📱 Template React Native
[ ] 🟢 Template Node.js/Express API
[ ] 🎨 Más temas y variantes
[ ] 🔌 Plugins y extensiones
[ ] 🌍 Soporte multiidioma
[ ] ☁️ Deploy automático

📄 Licencia

¿Te gusta create-devanthos-app? ⭐ ¡Dale una estrella en GitHub!

¿Necesitas ayuda? 💬 Únete a nuestro Discord

Hecho con 💜 por el equipo de Devanthos

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

🚀 create-devanthos-app

🌟 Características

🚀 Uso rápido

Modo Interactivo (Wizard)

Modo No-Interactivo (CLI Flags) 🆕

📦 Presets Predefinidos 🆕

Presets Disponibles

🎯 Plantillas disponibles

🌌 Astro Template

⚛️ Next.js Template

📱 Expo Template

📖 Guía paso a paso

1. Ejecutar el CLI

2. Seleccionar plantilla

3. Nombrar el proyecto

4. Confirmar instalación

5. ¡Proyecto creado!

💡 Ejemplos de uso

Crear proyecto Astro para landing page

Crear aplicación Next.js para dashboard

🔧 Configuración avanzada

Variables de entorno

Gestores de paquetes

🔌 Sistema de Plugins v2.0

📦 Plugins Disponibles

🚀 Instalar Plugins

✨ Características del Sistema

Crear tu Propio Plugin

🤖 Actualizaciones Automáticas

Características

Desactivar chequeos

Actualizar manualmente

�🛠️ Desarrollo y contribución

Clonar el repositorio

Probar localmente

Estructura del proyecto

Contribuir

🆘 Troubleshooting

Error: "Framework no soportado"

Error de permisos

Instalación de dependencias falla

Proyecto no se crea

📚 Recursos adicionales

🎨 Próximas funcionalidades

📄 Licencia