# 🚀 create-devanthos-app

<div align="center">

![Devanthos CLI](https://img.shields.io/badge/Devanthos-CLI-magenta?style=for-the-badge)
![npm version](https://img.shields.io/npm/v/create-devanthos-app?style=for-the-badge&color=green)
![Node.js](https://img.shields.io/badge/Node.js-20+-339933?style=for-the-badge&logo=node.js)
![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)

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

_Plantillas profesionales, optimizadas y listas para producción_ ✨

</div>

---

## 🌟 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)

```bash
# 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:

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

### Modo No-Interactivo (CLI Flags) 🆕

```bash
# 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](./CLI_FLAGS.md) - Guía de flags y opciones
- [Presets](./PRESETS.md) - Guía completa de presets y configuración

---

## 📦 Presets Predefinidos 🆕

Crea proyectos optimizados con configuraciones predefinidas:

```bash
# 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](./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

```bash
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!

```bash
cd mi-proyecto-devanthos
npm run dev
```

---

## 💡 Ejemplos de uso

### Crear proyecto Astro para landing page

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

### Crear aplicación Next.js para dashboard

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

---

## 🔧 Configuración avanzada

### Variables de entorno

```bash
# 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:

1. **pnpm** (recomendado) - Más rápido y eficiente
2. **yarn** - Alternativa robusta
3. **bun** - El más rápido (experimental)
4. **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:**

```bash
cd mi-proyecto
npx devanthos-plugins install
```

**Modo CLI:**

```bash
# 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:**

```bash
# 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](./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:**

```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

```bash
export DEVANTHOS_NO_UPDATE_CHECK=true
npx create-devanthos-app
```

### Actualizar manualmente

**Si instalaste globalmente:**

```bash
npm install -g create-devanthos-app@latest
```

**Si usas npx:**

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

---

## 🛠️ Desarrollo y contribución

### Clonar el repositorio

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

### Probar localmente

```bash
# Ejecutar el CLI en modo desarrollo
npm run dev

# Ejecutar tests
npm test          # modo watch
npm run test:run  # una sola ejecución

# Lint y formato
npm run lint
npm run format
```

### Estructura del proyecto

```
create-devanthos-app/
├── src/
│   ├── index.js              # CLI principal (punto de entrada)
│   └── utils/
│       ├── clone.js           # Copia de plantillas locales
│       ├── config.js          # Presets y configuración
│       ├── create-project.js  # Lógica centralizada de creación
│       ├── git.js             # Inicialización de Git
│       ├── install.js         # Instalación de dependencias
│       ├── integrations.js    # Sistema de integraciones
│       ├── paths.js           # Resolución de rutas del CLI
│       └── update.js          # Chequeo de actualizaciones
├── templates/
│   ├── astro-template-devanthos/
│   ├── next-template-devanthos/
│   └── expo-template-devanthos/
├── tests/
│   ├── clone.test.js
│   ├── config.test.js
│   ├── integrations.test.js
│   └── validate.test.js
├── package.json
├── vitest.config.js
├── tsconfig.json
└── README.md
```

### Contribuir

1. Fork del repositorio
2. Crea una branch: `git checkout -b feature/nueva-funcionalidad`
3. Commit: `git commit -m 'feat: nueva funcionalidad'`
4. Push: `git push origin feature/nueva-funcionalidad`
5. Abre un Pull Request

---

## 🆘 Troubleshooting

### Error: "Framework no soportado"

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

### Error de permisos

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

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

### Instalación de dependencias falla

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

### Proyecto no se crea

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

---

## 📚 Recursos adicionales

- 🌐 **Documentación:** [docs.devanthos.com](https://docs.devanthos.com)
- 💬 **Discord:** [discord.gg/devanthos](https://discord.gg/devanthos)
- 🐛 **Issues:** [GitHub Issues](https://github.com/devanthos/create-devanthos-app/issues)
- 📧 **Email:** hola@devanthos.com

---

## 🎨 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

MIT © [Devanthos](https://devanthos.com)

---

<div align="center">

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

**¿Necesitas ayuda?** 💬 [Únete a nuestro Discord](https://discord.gg/devanthos)

---

Hecho con 💜 por el equipo de [Devanthos](https://devanthos.com)

</div>