create-fullstack-setup 1.0.0

package/README.md

@@ -0,0 +1,391 @@
+# 🚀 create-fullstack-app
+
+> A modern CLI tool to generate production-ready backend or full-stack applications initial setup with Express in seconds.
+
+**create-fullstack-app** streamlines project setup by automating repetitive tasks like folder structure creation, dependency installation, middleware configuration, and environment setup—so you can focus on building features, not boilerplate.
+
+---
+
+## ✨ Features
+
+- 🎯 **Interactive Setup** - Guided prompts for a personalized project
+- ⚡ **Fast Scaffolding** - Ready-to-run projects in under a minute
+- 🔧 **Feature-Based** - Only include what you need (JWT, MongoDB, Cloudinary, etc.)
+- 📦 **Multiple Frontends** - Choose React, Next.js, or backend-only
+- 🛠️ **TypeScript & JavaScript** - Full support for both languages
+- 🌍 **Cross-Platform** - Works on Windows, macOS, and Linux
+- 📝 **Zero Configuration** - Pre-wired middleware and utilities
+
+---
+
+## 📋 Requirements
+
+- **Node.js** v18 or higher
+- **npm** v9 or higher
+
+---
+
+## 🔧 Installation
+
+Install the CLI globally via npm:
+
+```bash
+npm install -g create-fullstack-app
+```
+
+Verify the installation:
+
+```bash
+create-fullstack-app --version
+```
+
+---
+
+## 🚀 Quick Start
+
+### Create a new project
+
+```bash
+create-fullstack-app my-app
+```
+
+### Create in the current directory
+
+```bash
+create-fullstack-app .
+```
+
+The CLI will guide you through an interactive setup process.
+
+---
+
+## 📖 Interactive Setup Guide
+
+The CLI prompts you step-by-step to customize your project:
+
+### 1️⃣ **Project Name**
+Choose a name for your project folder.
+
+```
+? Project name: my-awesome-app
+```
+
+---
+
+### 2️⃣ **Frontend Framework** *(Optional)*
+
+Select a frontend framework or skip for a backend-only project:
+
+- **React** - Modern UI library
+- **Next.js** - Full-stack React framework
+- **None** - Backend API only
+
+```
+? Choose frontend framework: 
+  ○ React
+  ○ Next.js
+  ● None
+```
+
+---
+
+### 3️⃣ **Backend Framework**
+
+Currently supported:
+
+- **Express** - Fast, minimalist web framework
+
+```
+? Choose backend framework:
+  ● Express
+```
+
+---
+
+### 4️⃣ **Language**
+
+Choose your preferred language:
+
+- **JavaScript** - Classic, widely supported
+- **TypeScript** - Type-safe, modern development
+
+```
+? Select language:
+  ○ JavaScript
+  ● TypeScript
+```
+
+---
+
+### 5️⃣ **Backend Features**
+
+Enable features individually based on your needs:
+
+| Feature | Description |
+|---------|-------------|
+| **JWT Authentication** | Token-based auth with middleware |
+| **Cloudinary** | Cloud-based media management |
+| **CORS** | Cross-Origin Resource Sharing |
+| **Cookie Parser** | Parse cookies from requests |
+| **Dotenv** | Environment variable management |
+| **MongoDB** | NoSQL database with Mongoose ODM |
+| **Zod Validation** | Schema validation library |
+| **Bcrypt** | Password hashing utilities |
+| **Multer** | File upload handling |
+
+```
+? Enable JWT Authentication? (Y/n)
+? Enable Cloudinary? (Y/n)
+? Enable CORS? (Y/n)
+...
+```
+
+---
+
+## 📂 Generated Project Structure
+
+### Express + TypeScript
+
+```
+my-app/
+├── server/
+│   ├── src/
+│   │   ├── app.ts                  # Express app configuration
+│   │   ├── server.ts               # Server entry point
+│   │   ├── routes/                 # API routes
+│   │   ├── controllers/            # Request handlers
+│   │   ├── middlewares/
+│   │   │   └── auth.middleware.ts  # JWT authentication
+│   │   ├── utils/
+│   │   │   └── Cloudinary.ts       # Cloudinary setup
+│   │   └── config/
+│   │       └── db.ts               # MongoDB connection
+│   ├── .env.example                # Environment template
+│   ├── tsconfig.json               # TypeScript config
+│   ├── nodemon.json                # Dev server config
+│   └── package.json
+└── client/                         # (if frontend selected)
+    └── ...
+```
+
+### Express + JavaScript
+
+```
+my-app/
+├── server/
+│   ├── app.js                      # Express app configuration
+│   ├── server.js                   # Server entry point
+│   ├── routes/                     # API routes
+│   ├── controllers/                # Request handlers
+│   ├── middlewares/
+│   │   └── auth.middleware.js      # JWT authentication
+│   ├── utils/
+│   │   └── Cloudinary.js           # Cloudinary setup
+│   ├── .env.example                # Environment template
+│   └── package.json
+└── client/                         # (if frontend selected)
+    └── ...
+```
+
+---
+
+## ⚙️ Feature Details
+
+### 🔐 JWT Authentication
+
+When enabled, the CLI generates:
+
+- Authentication middleware for protected routes
+- Support for both `Authorization` header and HTTP-only cookies
+- Token verification utilities
+
+**Environment variable:**
+```env
+ACCESS_TOKEN_SECRET=your_secret_key_here
+```
+
+---
+
+### ☁️ Cloudinary Integration
+
+When enabled, the CLI generates:
+
+- Pre-configured Cloudinary utility class
+- Automatic connection on server startup
+- Ready-to-use upload/delete methods
+
+**Environment variables:**
+```env
+CLOUDINARY_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+```
+
+---
+
+### 🗄️ MongoDB (Mongoose)
+
+When enabled, the CLI generates:
+
+- Database connection utility
+- Automatic connection with retry logic
+- Connection error handling
+
+**Environment variable:**
+```env
+MONGO_URI=mongodb://localhost:27017/myapp
+```
+
+---
+
+### 🌐 CORS
+
+Enables Cross-Origin Resource Sharing with sensible defaults.
+
+---
+
+### 🍪 Cookie Parser
+
+Parses cookies from incoming requests for session management.
+
+---
+
+### 🔒 Bcrypt
+
+Utilities for hashing and comparing passwords securely.
+
+---
+
+### 📁 Multer
+
+Middleware for handling `multipart/form-data` file uploads.
+
+---
+
+### ✅ Zod Validation
+
+Schema-based validation for request data.
+
+---
+
+## 🔐 Environment Variables
+
+All required environment variables are written to:
+
+```
+server/.env.example
+```
+
+**Example file:**
+
+```env
+# Server
+PORT=5000
+
+# Authentication
+ACCESS_TOKEN_SECRET=your_jwt_secret_here
+
+# Cloudinary (if enabled)
+CLOUDINARY_NAME=
+CLOUDINARY_API_KEY=
+CLOUDINARY_API_SECRET=
+
+# Database (if MongoDB enabled)
+MONGO_URI=mongodb://localhost:27017/myapp
+```
+
+### ⚠️ Important
+
+Copy `.env.example` to `.env` and fill in your actual values before running:
+
+```bash
+cp server/.env.example server/.env
+```
+
+---
+
+## 🏃 Running Your Project
+
+### Backend
+
+```bash
+cd my-app/server
+npm install
+npm run dev
+```
+
+The server starts on `http://localhost:5000` (or your configured PORT).
+
+---
+
+### Frontend *(if generated)*
+
+```bash
+cd my-app/client
+npm install
+npm run dev
+```
+
+- **React**: Runs on `http://localhost:5173` (Vite default)
+- **Next.js**: Runs on `http://localhost:3000`
+
+---
+
+## 🎯 Use Cases
+
+- 🚀 **Rapid Prototyping** - Get ideas running quickly
+- 📚 **Learning Express** - Study well-structured projects
+- 👥 **Team Consistency** - Standardize project scaffolding
+- 🏗️ **Production Starters** - Begin with best practices
+
+---
+
+## 🛠️ Design Principles
+
+- ✅ **Feature-Based Injection** - Only include what you select
+- 📝 **Language Aware** - Respects JavaScript vs TypeScript conventions
+- 🔄 **Idempotent Operations** - No duplicate injections or overwrites
+- 🌍 **Cross-Platform** - Works on all operating systems
+- 📦 **Template Resolution** - Uses `__dirname` for global CLI safety
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to:
+
+- Report bugs
+- Suggest new features
+- Submit pull requests
+
+---
+
+## 👨‍💻 Author
+
+**Uttam Yadav**  
+Full-Stack Developer
+
+---
+
+## 📄 License
+
+[MIT](LICENSE)
+
+---
+
+## 📝 Notes
+
+- This CLI focuses on **project setup**, not application logic
+- Generated code is fully customizable—modify as needed
+- Templates follow industry best practices
+- No vendor lock-in—standard Express/Node.js code
+
+---
+
+## 🌟 Star this project
+
+If you find this tool helpful, consider giving it a star on GitHub!
+
+---
+
+**Happy Coding! 🎉**

package/bin/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+import inquirer from "inquirer";
+import chalk from "chalk";
+import { createProject } from "../utils/installer.js";
+
+console.log(chalk.green("\n🚀 Welcome to FullStack App Generator\n"));
+
+/* -------------------------------------------------------------------------- */
+/*                                   PROMPTS                                  */
+/* -------------------------------------------------------------------------- */
+
+const answers = await inquirer.prompt([
+  {
+    type: "input",
+    name: "projectName",
+    message: "Project name:",
+    validate: input => (input ? true : "Project name is required")
+  },
+  {
+    type: "list",
+    name: "frontend",
+    message: "Choose frontend:",
+    choices: ["React", "Next.js", "None"]
+  },
+  {
+    type: "list",
+    name: "backend",
+    message: "Choose backend:",
+    choices: ["Express"] // Fastify can be added later
+  },
+  {
+    type: "list",
+    name: "language",
+    message: "Choose language:",
+    choices: ["JavaScript", "TypeScript"]
+  },
+
+  /* ----------------------- Backend Feature Gate ---------------------------- */
+
+  {
+    type: "confirm",
+    name: "useBackendFeatures",
+    message: "Select backend features?",
+    default: true
+  },
+
+  /* ---------------------- Conditional Feature Prompts ---------------------- */
+
+  {
+    type: "confirm",
+    name: "useJWT",
+    message: "Use JWT authentication?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useCORS",
+    message: "Enable CORS?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useCookieParser",
+    message: "Use Cookie Parser?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useCloudinary",
+    message: "Use Cloudinary?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useMongoose",
+    message: "Use MongoDB (Mongoose)?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useZod",
+    message: "Use Zod validation?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useDotenv",
+    message: "Use Dotenv?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useBcrypt",
+    message: "Use Bcrypt for password hashing?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  },
+  {
+    type: "confirm",
+    name: "useMulter",
+    message: "Use Multer for file uploads?",
+    default: true,
+    when: ans => ans.useBackendFeatures
+  }
+]);
+
+
+/* -------------------------------------------------------------------------- */
+/*                       MAP ANSWERS → TEMPLATE KEYS                           */
+/* -------------------------------------------------------------------------- */
+
+const frontendMap = {
+  React: {
+    JavaScript: "react-js",
+    TypeScript: "react-ts"
+  },
+  "Next.js": {
+    JavaScript: "next-js",
+    TypeScript: "next-ts"
+  },
+  None: "None"
+};
+
+const backendMap = {
+  Express: {
+    JavaScript: "express-js",
+    TypeScript: "express-ts"
+  }
+};
+
+/* -------------------------------------------------------------------------- */
+/*                    BUILD backendFeatures ARRAY (IMPORTANT)                 */
+/* -------------------------------------------------------------------------- */
+
+const backendFeatures = [];
+
+if (answers.useBackendFeatures) {
+  if (answers.useJWT) backendFeatures.push("JWT");
+  if (answers.useCORS) backendFeatures.push("CORS");
+  if (answers.useCookieParser) backendFeatures.push("Cookie-Parser");
+  if (answers.useMongoose) backendFeatures.push("Mongoose");
+  if (answers.useCloudinary) backendFeatures.push("Cloudinary");
+  if (answers.useZod) backendFeatures.push("Zod");
+  if (answers.useDotenv) backendFeatures.push("Dotenv");
+  if (answers.useBcrypt) backendFeatures.push("Bcrypt");
+  if (answers.useMulter) backendFeatures.push("Multer");
+}
+
+/* -------------------------------------------------------------------------- */
+/*                            BUILD CONFIG OBJECT                              */
+/* -------------------------------------------------------------------------- */
+
+const config = {
+  projectName: answers.projectName,
+  frontend:
+    answers.frontend === "None"
+      ? "None"
+      : frontendMap[answers.frontend][answers.language],
+  backend: backendMap[answers.backend][answers.language],
+  backendFeatures // ✅ ALWAYS ARRAY
+};
+
+/* -------------------------------------------------------------------------- */
+/*                              CREATE PROJECT                                 */
+/* -------------------------------------------------------------------------- */
+
+await createProject(config);

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "create-fullstack-setup",
+  "version": "1.0.0",
+  "description": "CLI to generate ready-to-run fullstack or backend applications",
+  "bin": {
+    "create-fullstack-setup": "./bin/index.js"
+  },
+  "type": "module",
+  "keywords": [
+    "cli",
+    "express",
+    "fullstack",
+    "scaffold",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Uttam Yadav",
+  "license": "MIT"
+}

package/templates/backend/express-js/.env.example

@@ -0,0 +1,6 @@
+PORT=5000
+MONGO_URI=
+JWT_SECRET=
+CLOUDINARY_CLOUD_NAME=
+CLOUDINARY_API_KEY=
+CLOUDINARY_API_SECRET=

package/templates/backend/express-js/Utils/ApiError.js

@@ -0,0 +1,17 @@
+
+class ApiError extends Error{
+    constructor(statusCode,message="failed",errors=[],stack){
+        super(message),
+        this.statusCode=statusCode,
+        this.errors=errors;
+        
+        if(stack){
+            this.stack=stack
+        }
+        else{
+            Error.captureStackTrace(this,this.constructor);
+        }
+    }
+}
+
+export {ApiError}

package/templates/backend/express-js/Utils/ApiResponse.js

@@ -0,0 +1,12 @@
+
+class ApiResponse{
+    constructor(statusCode,data,message="sucess",sucess="sucess"){
+        this.statusCode=statusCode,
+        this.data=data,
+        this.message=message,
+        this.sucess=sucess
+    }
+
+}
+
+export {ApiResponse}

package/templates/backend/express-js/Utils/AsyncHandler.js

@@ -0,0 +1,8 @@
+const AsyncHandler = (reqHandler) => {
+    return (req, res, next) => {
+        Promise.resolve(reqHandler(req, res, next))
+            .catch((error) => next(error));
+    };
+};
+
+export { AsyncHandler };

package/templates/backend/express-js/Utils/Cloudinary.js

@@ -0,0 +1,31 @@
+import { v2 as cloudinary } from 'cloudinary';
+import fs from 'fs'
+
+    // Configuration
+    cloudinary.config({ 
+        cloud_name: process.env.CLOUDINARY_NAME, 
+        api_key: process.env.CLOUDINARY_APIKEY, 
+        api_secret:process.env.CLOUDINARY_APISECRET // Click 'View API Keys' above to copy your API secret
+    });
+    
+     // Upload an image
+     const uploadonCloudinary=async(localfilePath)=>{
+        try{
+        if(!localfilePath) return null;
+        const response=await cloudinary.uploader.upload(localfilePath,{
+            resource_type:"auto"
+        });
+        console.log("image upload on cloudinary",response.url);
+
+        fs.unlinkSync(localfilePath) //delete temp file after succesful upload
+        return response;
+
+        }
+        catch(error){
+            fs.unlinkSync(localfilePath);
+            return null;
+        }
+    
+     }
+
+     export {uploadonCloudinary}

package/templates/backend/express-js/app.js

@@ -0,0 +1,35 @@
+import express from "express";
+import dotenv from "dotenv";
+import cors from "cors";
+import cookieParser from "cookie-parser";
+
+dotenv.config();
+
+const app = express();
+
+app.use(express.json({ limit: "16kb" }));
+app.use(express.urlencoded({ extended: true, limit: "16kb" }));
+app.use(cookieParser());
+
+app.use(
+  cors({
+    origin:[ process.env.CORS_ORIGIN,
+      process.env.CORS_LOCAL_ORIGIN,
+    ],
+    credentials: true
+  })
+);
+
+
+const PORT = process.env.PORT || 3000;
+
+connectDB()
+  .then(() => {
+    app.listen(PORT, () => {
+      console.log(`Server is running on port ${PORT}`);
+    });
+  })
+  .catch((error) => {
+    console.error("Database connection failed", error);
+  });
+