🌙 create-moonslack-app

Crea apps Expo + React Native con arquitectura MVVM, soporte para Expo Router, y una base sólida de componentes Moonslack UI — todo con un solo comando.

🚀 Instalación rápida

# Crear un nuevo proyecto usando npx
npx create-moonslack-app mi-app

O si prefieres instalarlo globalmente:

pnpm add -g create-moonslack-app
create-moonslack-app mi-app

🧩 ¿Qué incluye?

El CLI genera una app lista para producción con:

• Expo SDK más reciente
• Estructura MVVM (Model–View–ViewModel)
• Expo Router para navegación moderna
• TypeScript + ESLint + Prettier
• Dark/Light mode preconfigurado
• Contextos base (AuthViewModel, ThemeContext, etc.)
• Moonslack UI Kit listo para usar
• Configuración inicial para Apple Sign-In, SecureStore, y AsyncStorage

🏗️ Estructura del proyecto generado

mi-app/
├── app/                   # Rutas y pantallas (Expo Router)
│   ├── (tabs)/            # Tabs principales
│   ├── auth/              # Login / Registro
│   └── _layout.tsx
├── src/
│   ├── viewmodels/        # Hooks de estado y lógica (MVVM)
│   ├── components/        # UI Components reutilizables
│   ├── context/           # Contextos globales (Auth, Theme, etc.)
│   ├── theme/             # Colores, tipografía, dark/light mode
│   ├── utils/             # Helpers y utilidades comunes
│   └── config/            # Constantes y settings
├── assets/                # Imágenes, íconos, fuentes
├── package.json
├── tsconfig.json
└── app.json

⚙️ Opciones del CLI

Al ejecutar el comando, se te pedirá el nombre del proyecto:

? Nombre de la app: my-awesome-app

Luego el CLI:

1. Crea la carpeta del proyecto.
2. Ejecuta pnpm create expo-app con el template base.
3. Copia la estructura template/ de Moonslack (MVVM + UI).
4. Limpia archivos innecesarios (.git, .expo, etc.).
5. Te deja listo para ejecutar pnpm start.

🧠 Scripts comunes

Dentro del proyecto generado podrás usar:

pnpm start        # Inicia el servidor de desarrollo
pnpm ios          # Ejecuta en iOS Simulator
pnpm android      # Ejecuta en Android
pnpm lint         # Revisa el código con ESLint
pnpm prettier     # Formatea el código

🪄 Ejemplo completo

npx create-moonslack-app mi-app
cd mi-app
pnpm start

Salida esperada:

🚀 Bienvenido a create-moonslack-app (Expo + MVVM)

? Nombre de la app: mi-app

📁 Creando carpeta /Users/you/mi-app...
⚙️  Generando base con Expo SDK más reciente...
📦 Aplicando estructura Moonslack...
✅ Proyecto creado con éxito!

👉 cd mi-app && pnpm start

🧰 Requisitos

• Node.js ≥ 18
• pnpm ≥ 8.0.0 (recomendado)
• Git instalado
• macOS o Windows con soporte Expo CLI

Puedes instalar pnpm con:

npm i -g pnpm

🪶 Filosofía del CLI

create-moonslack-app busca:

• Estándar uniforme entre proyectos (MVVM + Expo Router)
• Integración nativa con Moonslack UI y patrones de diseño consistentes
• Productividad inmediata sin configuración manual
• Ideal para crear apps con autenticación, modo oscuro, IA o módulos SaaS

📦 Publicación

Para mantener tu CLI actualizado:

# Actualiza la versión
pnpm version patch

# Publica en npm
npm publish --access public

🤝 Contribución

¿Quieres mejorar la plantilla o agregar nuevos templates (por ejemplo --template saas o --template ai)?

1. Clona este repositorio
2. Edita el contenido del folder /template
3. Prueba localmente con:

   pnpm link --global
   create-moonslack-app test

4. Abre un PR o comparte tus mejoras 🚀

🧩 Roadmap

• [ ] Soporte para múltiples templates (--template auth, --template saas)
• [ ] Inicializador con configuración de Supabase / Firebase
• [ ] Integración opcional de Moonslack UI Kit desde npm
• [ ] Postinstall automático con dependencias base

🧑‍💻 Autor

Moonslack Labs
Creadores de experiencias hermosas con Expo, React Native y AI.
🌐 moonslack.com

📄 Licencia

MIT © 2025 Moonslack Labs