🚀 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.

📦 Instalación Global

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

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)

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

cd my-awesome-app

2. Instala y ejecuta frontend

cd frontend
npm install
npm run dev

3. En otra terminal, ejecuta backend

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:

# backend/.env
PORT=3001
DATABASE_URL=postgresql://user:password@localhost/dbname
JWT_SECRET=your-secret-key

Scripts Disponibles

Cada proyecto genera scripts útiles:

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

docker-compose up --build

Esto levantará frontend, backend y base de datos en contenedores.

📚 Ejemplos Prácticos

React + Express + SQLite

novatec create blog-app --frontend react --backend express
cd blog-app/backend
npm install sqlite3 cors dotenv

Next.js + NestJS + PostgreSQL

novatec create saas-app --frontend next --backend nestjs
cd saas-app/backend
npm install @nestjs/typeorm typeorm pg

Vue + FastAPI

novatec create dashboard --frontend vue --backend fastapi
cd dashboard/backend
pip install sqlalchemy psycopg2

⚡ Flags Disponibles

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

# 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

node --version

Problemas con Python

Asegúrate de tener Python >= 3.8:

python --version
pip install virtualenv

Limpia caché si hay problemas

npm cache clean --force
npm install -g novatec-fullstack-cli@latest

🛠️ Desarrollo Local

Para trabajar en el CLI mismo:

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:

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

🎉 Gracias por usar NOVATEC Fullstack CLI

Hecho con ❤️ por NOVATEC

Versión: 1.0.0
Última actualización: Mayo 2026