novatec-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NOVATEC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,331 @@
+# 🚀 NOVATEC Fullstack CLI
+
+> **Generador profesional de proyectos full stack** — Crea proyectos listos para producción en segundos con tu combinación favorita de frontend y backend.
+
+[![npm version](https://img.shields.io/npm/v/novatec-fullstack-cli.svg?style=flat)](https://www.npmjs.com/package/novatec-fullstack-cli)
+[![Node version](https://img.shields.io/node/v/novatec-fullstack-cli.svg?style=flat)](https://nodejs.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)
+
+---
+
+## 📦 Instalación Global
+
+```bash
+npm install -g novatec-fullstack-cli
+```
+
+Después de instalar, el comando `novatec` estará disponible globalmente en tu terminal.
+
+---
+
+## 🎯 Uso Rápido
+
+### Crear un nuevo proyecto
+
+```bash
+novatec create my-awesome-app
+```
+
+El CLI te guiará interactivamente para elegir:
+
+- **Frontend**: React, Next.js, Vue, Nuxt, Astro, Svelte, SolidJS, Angular, Remix, Qwik
+- **Backend**: Express, NestJS, Fastify, Hono, FastAPI, Django, Flask, Spring Boot, Deno, Go/Gin
+- **Dependencias adicionales** por framework
+
+### Con flags (opcional)
+
+```bash
+novatec create my-app --frontend react --backend express
+```
+
+---
+
+## 🛠️ Tecnologías Soportadas
+
+### Frontend
+
+| Framework | Bundler | Características |
+|-----------|---------|-----------------|
+| **React** | Vite | SPA rápida, 18+, hooks |
+| **Next.js** | Next.js | SSR, SSG, App Router, FullStack |
+| **Vue** | Vite | SPA reactiva, Composition API |
+| **Nuxt** | Nuxt | SSR/SSG, i18n, módulos |
+| **Astro** | Astro | MPA ultra-rápido, islands |
+| **Svelte** | SvelteKit | SSR/SSG, reactividad única |
+| **SolidJS** | Vite | Reactividad sin Virtual DOM |
+| **Angular** | Angular CLI | Enterprise-grade |
+| **Remix** | Remix | Full-stack React, loaders |
+| **Qwik** | Qwik | Resumability, carga instantánea |
+
+### Backend
+
+| Framework | Runtime | Características |
+|-----------|---------|-----------------|
+| **Express** | Node.js | Minimalista, flexible |
+| **NestJS** | Node.js | Modular, TypeScript-first |
+| **Fastify** | Node.js | Ultra-rápido, plugins |
+| **Hono** | Node.js/Edge | Ligero, edge-ready |
+| **FastAPI** | Python | Async, auto-docs |
+| **Django** | Python | Batteries-included |
+| **Flask** | Python | Micro-framework flexible |
+| **Spring Boot** | Java | Enterprise, robusto |
+| **Deno** | Deno | TypeScript seguro |
+| **Go/Gin** | Go | Alto rendimiento |
+
+---
+
+## 📁 Estructura Generada
+
+```
+my-awesome-app/
+├── frontend/
+│   ├── src/
+│   ├── public/
+│   ├── package.json
+│   └── [config files]
+├── backend/
+│   ├── src/ (o app/ para Python)
+│   ├── package.json (o requirements.txt para Python)
+│   └── [config files]
+├── README.md
+└── .gitignore (opcional)
+```
+
+---
+
+## 🚀 Primeros Pasos
+
+Después de crear tu proyecto:
+
+### 1. Navega al directorio
+
+```bash
+cd my-awesome-app
+```
+
+### 2. Instala y ejecuta frontend
+
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+### 3. En otra terminal, ejecuta backend
+
+```bash
+cd backend
+npm install      # o 'pip install -r requirements.txt' para Python
+npm run dev      # o el comando específico del framework
+```
+
+### 4. Comienza a desarrollar
+
+- **Frontend**: Abre `http://localhost:5173` (Vite) o `http://localhost:3000` (Next.js)
+- **Backend**: Típicamente en `http://localhost:3001` (Node) o `http://localhost:8000` (Python)
+
+---
+
+## 🎨 Dependencias Opcionales
+
+El CLI te permite agregar dependencias populares:
+
+### Frontend
+- `axios`, `react-router-dom`, `zustand`, `tailwindcss`, `shadcn/ui`, `framer-motion`, etc.
+
+### Backend
+- `cors`, `helmet`, `socket.io`, `swagger-ui-express`, `typeorm`, `prisma`, etc.
+
+### Extras
+- **.env**: Archivos de configuración
+- **ESLint + Prettier**: Linting y formato
+- **Husky**: Git hooks
+- **Testing**: Jest, Vitest, pytest
+- **CI/CD**: GitHub Actions
+- **Docker**: Dockerfiles y docker-compose
+
+---
+
+## 🔧 Configuración Avanzada
+
+### Variables de Entorno
+
+Después de crear tu proyecto, configura `.env` en frontend y backend:
+
+```bash
+# backend/.env
+PORT=3001
+DATABASE_URL=postgresql://user:password@localhost/dbname
+JWT_SECRET=your-secret-key
+```
+
+### Scripts Disponibles
+
+Cada proyecto genera scripts útiles:
+
+```bash
+# Frontend (generalmente)
+npm run dev       # Desarrollo
+npm run build     # Build para producción
+npm run preview   # Preview del build
+
+# Backend (Node.js)
+npm run dev       # Desarrollo con nodemon
+npm start         # Producción
+
+# Backend (Python)
+pip install -r requirements.txt
+python main.py    # FastAPI
+python manage.py runserver  # Django
+python run.py     # Flask
+```
+
+---
+
+## 🐳 Docker (Opcional)
+
+Si seleccionas Docker en extras, obtendrás:
+
+```bash
+docker-compose up --build
+```
+
+Esto levantará frontend, backend y base de datos en contenedores.
+
+---
+
+## 📚 Ejemplos Prácticos
+
+### React + Express + SQLite
+
+```bash
+novatec create blog-app --frontend react --backend express
+cd blog-app/backend
+npm install sqlite3 cors dotenv
+```
+
+### Next.js + NestJS + PostgreSQL
+
+```bash
+novatec create saas-app --frontend next --backend nestjs
+cd saas-app/backend
+npm install @nestjs/typeorm typeorm pg
+```
+
+### Vue + FastAPI
+
+```bash
+novatec create dashboard --frontend vue --backend fastapi
+cd dashboard/backend
+pip install sqlalchemy psycopg2
+```
+
+---
+
+## ⚡ Flags Disponibles
+
+```bash
+novatec create <project-name> [options]
+
+Options:
+  --frontend <type>   Frontend framework (react, next, vue, nuxt, astro, svelte, solid, angular, remix, qwik)
+  --backend <type>    Backend framework (express, nestjs, fastify, hono, fastapi, django, flask, spring, deno, gin)
+  -h, --help          Mostrar ayuda
+  -v, --version       Mostrar versión
+```
+
+---
+
+## 🐛 Solución de Problemas
+
+### El comando `novatec` no se reconoce
+
+```bash
+# Reinstala globalmente
+npm install -g novatec-fullstack-cli
+
+# O crea un symlink local
+npm link
+```
+
+### Error: Node version too old
+
+Necesitas Node.js >= 18. Descarga desde [nodejs.org](https://nodejs.org)
+
+```bash
+node --version
+```
+
+### Problemas con Python
+
+Asegúrate de tener Python >= 3.8:
+
+```bash
+python --version
+pip install virtualenv
+```
+
+### Limpia caché si hay problemas
+
+```bash
+npm cache clean --force
+npm install -g novatec-fullstack-cli@latest
+```
+
+---
+
+## 🛠️ Desarrollo Local
+
+Para trabajar en el CLI mismo:
+
+```bash
+git clone https://github.com/yourusername/novatec-fullstack-cli.git
+cd novatec-fullstack-cli
+npm install
+npm link
+novatec create test-app
+```
+
+---
+
+## 📦 Publicación en npm
+
+Cuando esté listo para publicar:
+
+```bash
+npm login
+npm publish
+```
+
+---
+
+## 📝 Licencia
+
+MIT © NOVATEC
+
+---
+
+## 🤝 Contribuciones
+
+Las contribuciones son bienvenidas. Por favor:
+
+1. Haz fork del proyecto
+2. Crea una rama (`git checkout -b feature/feature-name`)
+3. Commit tus cambios (`git commit -am 'Add feature'`)
+4. Push a la rama (`git push origin feature/feature-name`)
+5. Abre un Pull Request
+
+---
+
+## 🙋 Soporte
+
+¿Tienes problemas? Abre una [issue](https://github.com/yourusername/novatec-fullstack-cli/issues)
+
+---
+
+## 🎉 Gracias por usar NOVATEC Fullstack CLI
+
+Hecho con ❤️ por NOVATEC
+
+**Versión**: 1.0.0  
+**Última actualización**: Mayo 2026

package/bin/index.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+import boxen from 'boxen';
+import chalkAnimation from 'chalk-animation';
+import { checkRequirements } from '../lib/utils.js';
+import { runCreate } from '../lib/create.js';
+
+function sleep(ms) {
+  return new Promise(r => setTimeout(r, ms));
+}
+
+// Cicla cada carácter entre morado puro → blanco → morado oscuro (efecto RGB)
+function rgbCycle(text, offset = 0) {
+  const palette = [
+    [120,  0, 200], // morado oscuro
+    [160,  0, 255], // morado puro
+    [190, 60, 255], // morado medio
+    [215,120, 255], // lavanda
+    [235,180, 255], // lavanda claro
+    [255,255, 255], // blanco
+    [235,180, 255], // lavanda claro
+    [215,120, 255], // lavanda
+    [190, 60, 255], // morado medio
+    [160,  0, 255], // morado puro
+  ];
+  return text.split('').map((ch, i) => {
+    if (ch === ' ') return ch;
+    const [r, g, b] = palette[(i + offset) % palette.length];
+    return chalk.rgb(r, g, b)(ch);
+  }).join('');
+}
+
+async function showBanner() {
+  console.clear();
+
+  const logo = figlet.textSync('NOVATEC', { font: 'ANSI Shadow' });
+  const lines = logo.split('\n').filter(l => l.trim());
+
+  // Animación: el gradiente RGB "corre" a través del texto
+  const FRAMES = 20;
+  for (let frame = 0; frame < FRAMES; frame++) {
+    if (frame > 0) process.stdout.write(`\x1B[${lines.length + 1}A`);
+    console.log();
+    lines.forEach((line, i) => {
+      console.log('  ' + rgbCycle(line, frame * 3 + i * 4));
+    });
+    await sleep(55);
+  }
+
+  console.log();
+
+  // Subtítulo: animación glitch → queda fijo con gradiente morado-blanco
+  const sub = '  ◆  NOVATEC FULLSTACK CLI  —  Generador Profesional de Proyectos  ◆';
+  const anim = chalkAnimation.glitch(sub);
+  await sleep(1200);
+  anim.stop();
+  process.stdout.write('\r');
+  console.log(gradient(['#7B00FF', '#FFFFFF', '#7B00FF'])(sub));
+  console.log();
+
+  // Separador RGB
+  const sep = '═'.repeat(64);
+  console.log('  ' + rgbCycle(sep, 0));
+  console.log();
+
+  // Caja de tecnologías
+  console.log(
+    boxen(
+      gradient(['#7B00FF', '#FFFFFF', '#7B00FF'])('  ⚡ TECNOLOGÍAS DISPONIBLES ⚡') + '\n\n' +
+      chalk.bold.white('  Frontend  ') + chalk.gray('│ ') +
+      [
+        chalk.hex('#61DAFB')('React (Vite)'),
+        chalk.white('Next.js'),
+        chalk.hex('#42B883')('Vue'),
+        chalk.hex('#00DC82')('Nuxt'),
+        chalk.hex('#FF5D01')('Astro'),
+        chalk.hex('#FF3E00')('Svelte'),
+        chalk.hex('#4F8EF7')('Solid'),
+        chalk.hex('#DD0031')('Angular'),
+        chalk.hex('#E8F2FF')('Remix'),
+        chalk.hex('#AC7EF4')('Qwik'),
+      ].join(chalk.gray(' · ')) + '\n\n' +
+      chalk.bold.white('  Backend   ') + chalk.gray('│ ') +
+      [
+        chalk.hex('#68A063')('Express'),
+        chalk.hex('#E0234E')('NestJS'),
+        chalk.white('Fastify'),
+        chalk.hex('#E36002')('Hono'),
+        chalk.hex('#009688')('FastAPI'),
+        chalk.hex('#44B78B')('Django'),
+        chalk.gray('Flask'),
+        chalk.hex('#6DB33F')('Spring'),
+        chalk.white('Deno'),
+        chalk.hex('#00ADD8')('Go/Gin'),
+      ].join(chalk.gray(' · ')),
+      {
+        padding: { top: 1, bottom: 1, left: 3, right: 3 },
+        margin: { left: 2 },
+        borderStyle: 'double',
+        borderColor: 'magenta',
+      }
+    )
+  );
+
+  console.log();
+  console.log('  ' + rgbCycle(sep, 8));
+  console.log();
+}
+
+program
+  .name('novatec-cli')
+  .description('NOVATEC FULLSTACK CLI — Generador profesional de proyectos full stack')
+  .version('1.0.0', '-v, --version', 'Mostrar versión');
+
+program
+  .command('create [name]')
+  .description('Crear un nuevo proyecto full stack')
+  .option('--frontend <type>', 'react | next | vue | nuxt | astro | svelte | solid | angular | remix | qwik')
+  .option('--backend <type>',  'express | nestjs | fastify | hono | fastapi | django | flask | spring | deno | gin')
+  .action(async (name, options) => {
+    await showBanner();
+    try {
+      await checkRequirements();
+      await runCreate(name, options);
+    } catch (err) {
+      console.error(
+        boxen(
+          chalk.red.bold('✖  ERROR\n\n') + chalk.white(err.message),
+          { padding: 1, borderColor: 'red', borderStyle: 'round' }
+        )
+      );
+      process.exit(1);
+    }
+  });
+
+if (!process.argv.slice(2).length) {
+  (async () => {
+    await showBanner();
+    program.outputHelp();
+  })();
+} else {
+  program.parse(process.argv);
+}