create-fullstack-boilerplate 2.1.10 → 2.2.0

package/README.md

@@ -1,4 +1,4 @@
-# create-fullstack-app
+# create-fullstack-boilerplate
 
 A powerful CLI tool to quickly scaffold a complete fullstack application with React, Node.js, Express, and Sequelize with multi-database support. Get started building real features instead of spending time on project setup!
 
@@ -25,14 +25,14 @@ A powerful CLI tool to quickly scaffold a complete fullstack application with Re
 ### Create a New Project
 
 ```bash
-npx create-fullstack-app
+npx create-fullstack-boilerplate
 ```
 
 Or install globally:
 
 ```bash
-npm install -g create-fullstack-app
-create-fullstack-app
+npm install -g create-fullstack-boilerplate
+create-fullstack-boilerplate
 ```
 
 Follow the interactive prompts:
@@ -73,7 +73,7 @@ npm run dev
 Navigate to your project root and run:
 
 ```bash
-npx create-fullstack-app add-db
+npx create-fullstack-boilerplate add-db
 ```
 
 The CLI will prompt you for:
@@ -125,7 +125,7 @@ The CLI provides appropriate data types based on your selected database dialect:
 Navigate to your project root and run:
 
 ```bash
-npx create-fullstack-app add-route
+npx create-fullstack-boilerplate add-route
 ```
 
 The CLI will prompt you for:

package/index.js

@@ -133,144 +133,4 @@
         }
         process.exit(1);
     }
-})();
-
-
-
-// #!/usr/bin/env node
-
-// (async () => {
-//     const argv = process.argv.slice(2);
-
-//     if (argv[0] === "add-db") {
-//         await require("./lib/addDB")();
-//         return;
-//     }
-
-//     if (argv[0] === "add-route") {
-//         await require("./lib/addRoute")();
-//         return;
-//     }
-
-//     // ---- Your existing create-project code ----
-//     const path = require("path");
-//     // const { ensure } = require("./lib/utils");
-//     const copyProject = require('./lib/copyProject')
-//     const { runInstall, installDBDriver } = require("./lib/utils");
-//     const setupMainDB = require("./lib/setupMainDB");
-//     const setupExtraDB = require("./lib/setupExtraDB");
-//     const testDBConnection = require("./lib/testDBConnection");
-//     const { mainPrompts, extraDBPrompts } = require("./lib/prompts");
-
-//     const fs = require("fs-extra");
-
-
-//     // Resolve template folder dynamically
-//     let templateDir;
-
-//     // Try __dirname first (works for local/dev)
-//     const localTemplate = path.resolve(__dirname, "template");
-//     console.log("🔍 Checking local template:", localTemplate);
-
-//     if (fs.existsSync(localTemplate)) {
-//         templateDir = localTemplate;
-//         console.log("✅ Found local template");
-//     } else {
-//         // Fallback for npx (temp folder)
-//         try {
-//             const pkg = require.resolve("create-fullstack-boilerplate/package.json");
-//             templateDir = path.resolve(path.dirname(pkg), "template");
-//             console.log("✅ Found npm template:", templateDir);
-//         } catch (err) {
-//             console.error("❌ Could not resolve package:", err.message);
-//         }
-//     }
-
-//     if (!templateDir || !fs.existsSync(templateDir)) {
-//         throw new Error(
-//             `Template folder not found!\nSearched: ${localTemplate}\nMake sure 'template' is included in package.json 'files' field.`
-//         );
-//     }
-
-//     console.log("✅ Using template folder:", templateDir);
-
-//     console.log("=== DEBUG INFO ===");
-//     console.log("Current directory:", process.cwd());
-//     console.log("Template directory:", templateDir);
-//     console.log("Template exists:", fs.existsSync(templateDir));
-//     if (fs.existsSync(templateDir)) {
-//         console.log("Template contents:", fs.readdirSync(templateDir));
-//     }
-//     console.log("==================");
-
-
-//     try {
-//         console.log("\n🎛️  Setting Up Full Stack Project...\n");
-
-//         const answers = await mainPrompts();
-//         const targetDir = path.join(process.cwd(), answers.projectName);
-
-//         console.log("Target directory:", targetDir);
-
-//         // Remove the IIFE wrapper and just await directly
-//         try {
-//             console.log("📁 Copying project files...");
-//             await copyProject(templateDir, targetDir);
-//             console.log("✅ Project copied successfully");
-//         } catch (err) {
-//             console.error("❌ Failed to copy project files:", err.message);
-//             throw err; // Re-throw to stop execution
-//         }
-
-//         await setupMainDB(targetDir, answers.dbDialect);
-//         console.log("➡️ Installing backend dependencies...");
-//         await runInstall(path.join(targetDir, "Backend"));
-
-//         console.log("➡️ Installing frontend dependencies...");
-//         await runInstall(path.join(targetDir, "Frontend"));
-
-//         console.log("➡️ Installing Your Db Dialect: ", answers.dbDialect)
-//         await installDBDriver(path.join(targetDir, "Backend"), answers.dbDialect);
-
-
-//         if (answers.addExtraDB) {
-//             const extraDB = await extraDBPrompts();
-//             console.log(`\n🔍 Testing connection for ${extraDB.dbKey}...`);
-//             await installDBDriver(path.join(targetDir, "Backend"), extraDB.dialect);
-//             const ok = await testDBConnection(targetDir, extraDB);
-
-//             if (ok) {
-//                 await setupExtraDB(targetDir, extraDB);
-//                 console.log(`✅ Extra DB '${extraDB.dbKey}' successfully integrated.\n`);
-//             } else {
-//                 console.log(`⚠️ Connection failed. Skipping extra DB setup.\n`);
-//             }
-//         }
-
-//         if (answers.initGit) {
-//             try {
-//                 const execa = require("execa").execa || require("execa");
-//                 await execa("git", ["init"], { cwd: targetDir });
-//                 if (answers.remoteRepo) {
-//                     await execa("git", ["remote", "add", "origin", answers.remoteRepo], { cwd: targetDir });
-//                 }
-//                 console.log("✅ Git initialized.\n");
-//             } catch (gitErr) {
-//                 console.log(`⚠️ Git initialization failed: ${gitErr.message}`);
-//                 console.log(`   You can initialize git manually later.\n`);
-//             }
-//         }
-
-//         console.log(`\n🎉 Project Ready!`);
-//         console.log(`\n➡️ Next Steps:`);
-//         console.log(`   cd ${answers.projectName}`);
-//         console.log(`   cd backend && npm run dev`);
-//         console.log(`   cd ../frontend && npm run dev\n`);
-//     } catch (err) {
-//         console.error(`\n❌ Error creating project: ${err.message}\n`);
-//         if (err.stack && process.env.DEBUG) {
-//             console.error(err.stack);
-//         }
-//         process.exit(1);
-//     }
-// })();
+})();

package/lib/addDB.js

@@ -2,8 +2,6 @@ const path = require("path");
 const { extraDBPrompts } = require("./prompts");
 const testDBConnection = require("./testDBConnection");
 const setupExtraDB = require("./setupExtraDB");
-// const { ensure } = require("./utils");
-// const fs = ensure("fs-extra");
 const fs = require("fs-extra");
 
 

package/lib/addRoute.js

@@ -1,7 +1,5 @@
 const path = require("path");
-// const { ensure } = require("./utils");
 const { routePrompts } = require("./prompts");
-// const fs = ensure("fs-extra");
 const fs = require("fs-extra");
 
 
@@ -28,7 +26,7 @@ module.exports = async function addRoute() {
     try {
         // Get route info from user
         const routeInfo = await routePrompts();
-        
+
         const routeFileName = `${routeInfo.routeName}Routes.js`;
         const serviceFileName = `${routeInfo.routeName}Service.js`;
         const routeFilePath = path.join(routesDir, routeFileName);
@@ -71,10 +69,10 @@ module.exports = async function addRoute() {
 };
 
 function generateRouteFile(routeInfo) {
-    const requireAuth = routeInfo.needsAuth 
-        ? `const { authenticateToken } = require('../middleware/authMiddleware');\n` 
+    const requireAuth = routeInfo.needsAuth
+        ? `const { authenticateToken } = require('../middleware/authMiddleware');\n`
         : '';
-    
+
     const authMiddleware = routeInfo.needsAuth ? 'authenticateToken, ' : '';
 
     return `const express = require('express');

package/lib/copyProject.js

@@ -1,6 +1,5 @@
 const path = require("path");
 const fs = require("fs-extra");
-const { normalizePath } = require("./utils");
 
 module.exports = async function copyProject(src, dest) {
     try {

package/lib/prompts.js

@@ -46,8 +46,8 @@ module.exports.mainPrompts = () => {
 
 module.exports.extraDBPrompts = async () => {
     const basicInfo = await inquirer.prompt([
-        { 
-            name: 'dbKey', 
+        {
+            name: 'dbKey',
             message: 'DB Identifier (e.g., REPORTING_DB):',
             validate: (input) => {
                 if (!input || input.trim().length === 0) {
@@ -63,9 +63,9 @@ module.exports.extraDBPrompts = async () => {
         { name: 'username', message: 'DB Username:', validate: (input) => input.trim().length > 0 ? true : 'Cannot be empty' },
         { name: 'password', message: 'DB Password:' },
         { name: 'host', message: 'DB Host:', default: 'localhost' },
-        { 
-            name: 'port', 
-            message: 'DB Port:', 
+        {
+            name: 'port',
+            message: 'DB Port:',
             default: '3306',
             validate: (input) => {
                 const port = parseInt(input);
@@ -81,9 +81,9 @@ module.exports.extraDBPrompts = async () => {
             message: 'DB Dialect:',
             choices: ['mysql', 'mariadb', 'postgres']
         },
-        { 
-            name: 'tableName', 
-            message: 'Model / Table Name:', 
+        {
+            name: 'tableName',
+            message: 'Model / Table Name:',
             default: 'sample_table',
             validate: (input) => {
                 if (!input || input.trim().length === 0) {
@@ -113,9 +113,9 @@ module.exports.extraDBPrompts = async () => {
 
 async function collectTableAttributes(dialect) {
     const attributes = [];
-    
+
     console.log('\n📋 Define table attributes. Start with the primary key.\n');
-    
+
     // Primary key first
     const pkAnswers = await inquirer.prompt([
         {

package/lib/setupExtraDB.js

@@ -1,24 +1,22 @@
 const path = require("path");
-// const { ensure } = require("./utils");
-// const fs = ensure("fs-extra");
-const fs = require("fs-extra"); // no assert needed
+const fs = require("fs-extra");
 
 
 module.exports = async function setupExtraDB(targetDir, dbConfig) {
-    const backendDir = path.join(targetDir, "Backend");
-    const modelsDir = path.join(backendDir, "Models");
-    const dbDir = path.join(backendDir, "DB");
-
-    // 1. Create folder for this DB's models
-    const dbFolderName = dbConfig.dbKey;
-    const dbModelsFolder = path.join(modelsDir, dbFolderName);
-    await fs.ensureDir(dbModelsFolder);
-
-    // 2. Create config file for this DB
-    const configFileName = `${dbFolderName}.config.js`;
-    const configPath = path.join(dbDir, configFileName);
-    
-    const configContent = `module.exports = {
+  const backendDir = path.join(targetDir, "Backend");
+  const modelsDir = path.join(backendDir, "Models");
+  const dbDir = path.join(backendDir, "DB");
+
+  // 1. Create folder for this DB's models
+  const dbFolderName = dbConfig.dbKey;
+  const dbModelsFolder = path.join(modelsDir, dbFolderName);
+  await fs.ensureDir(dbModelsFolder);
+
+  // 2. Create config file for this DB
+  const configFileName = `${dbFolderName}.config.js`;
+  const configPath = path.join(dbDir, configFileName);
+
+  const configContent = `module.exports = {
   development: {
     username: process.env.${dbConfig.dbKey}_USER || "${dbConfig.username}",
     password: process.env.${dbConfig.dbKey}_PASSWORD || "${dbConfig.password}",
@@ -46,91 +44,91 @@ module.exports = async function setupExtraDB(targetDir, dbConfig) {
 };
 `;
 
-    await fs.writeFile(configPath, configContent);
+  await fs.writeFile(configPath, configContent);
+
+  // 3. Create a sample model file
+  const modelContent = generateModelContent(dbConfig);
+  const modelFileName = `${dbConfig.tableName}.js`;
+  const modelPath = path.join(dbModelsFolder, modelFileName);
+  await fs.writeFile(modelPath, modelContent);
 
-    // 3. Create a sample model file
-    const modelContent = generateModelContent(dbConfig);
-    const modelFileName = `${dbConfig.tableName}.js`;
-    const modelPath = path.join(dbModelsFolder, modelFileName);
-    await fs.writeFile(modelPath, modelContent);
+  // 4. Update dbConfigs.js to register this DB
+  const dbConfigsPath = path.join(dbDir, "dbConfigs.js");
+  let dbConfigsContent = await fs.readFile(dbConfigsPath, "utf8");
 
-    // 4. Update dbConfigs.js to register this DB
-    const dbConfigsPath = path.join(dbDir, "dbConfigs.js");
-    let dbConfigsContent = await fs.readFile(dbConfigsPath, "utf8");
-    
-    const newEntry = `  {
+  const newEntry = `  {
     key: "${dbConfig.dbKey}",
     folder: "${dbConfig.dbKey}",
     configPath: "/../DB/${configFileName}"
   }`;
 
-    // Insert before the closing bracket
-    dbConfigsContent = dbConfigsContent.replace(
-        /const dbConfigs = \[\s*\];/,
-        `const dbConfigs = [
+  // Insert before the closing bracket
+  dbConfigsContent = dbConfigsContent.replace(
+    /const dbConfigs = \[\s*\];/,
+    `const dbConfigs = [
 ${newEntry}
 ];`
-    );
+  );
 
-    // If there are already entries, append
-    if (!dbConfigsContent.includes(newEntry) && dbConfigsContent.includes("const dbConfigs = [")) {
-        dbConfigsContent = dbConfigsContent.replace(
-            /(const dbConfigs = \[[\s\S]*?)(\];)/,
-            `$1,
+  // If there are already entries, append
+  if (!dbConfigsContent.includes(newEntry) && dbConfigsContent.includes("const dbConfigs = [")) {
+    dbConfigsContent = dbConfigsContent.replace(
+      /(const dbConfigs = \[[\s\S]*?)(\];)/,
+      `$1,
 ${newEntry}
 $2`
-        );
-    }
+    );
+  }
 
-    await fs.writeFile(dbConfigsPath, dbConfigsContent);
-
-    // 5. Update .env file with DB credentials
-    const envPath = path.join(backendDir, ".env");
-    let envContent = await fs.readFile(envPath, "utf8");
-    
-    const envVars = `\n# ${dbConfig.dbKey} Database Configuration\n${dbConfig.dbKey}_USER=${dbConfig.username}\n${dbConfig.dbKey}_PASSWORD=${dbConfig.password}\n${dbConfig.dbKey}_NAME=${dbConfig.database}\n${dbConfig.dbKey}_HOST=${dbConfig.host}\n${dbConfig.dbKey}_PORT=${dbConfig.port}\n`;
-    
-    if (!envContent.includes(`${dbConfig.dbKey}_USER`)) {
-        envContent += envVars;
-        await fs.writeFile(envPath, envContent);
-    }
+  await fs.writeFile(dbConfigsPath, dbConfigsContent);
+
+  // 5. Update .env file with DB credentials
+  const envPath = path.join(backendDir, ".env");
+  let envContent = await fs.readFile(envPath, "utf8");
+
+  const envVars = `\n# ${dbConfig.dbKey} Database Configuration\n${dbConfig.dbKey}_USER=${dbConfig.username}\n${dbConfig.dbKey}_PASSWORD=${dbConfig.password}\n${dbConfig.dbKey}_NAME=${dbConfig.database}\n${dbConfig.dbKey}_HOST=${dbConfig.host}\n${dbConfig.dbKey}_PORT=${dbConfig.port}\n`;
 
-    console.log(`✅ Database '${dbConfig.dbKey}' configured successfully.`);
+  if (!envContent.includes(`${dbConfig.dbKey}_USER`)) {
+    envContent += envVars;
+    await fs.writeFile(envPath, envContent);
+  }
+
+  console.log(`✅ Database '${dbConfig.dbKey}' configured successfully.`);
 };
 
 function generateModelContent(dbConfig) {
-    const modelName = dbConfig.tableName.charAt(0).toUpperCase() + dbConfig.tableName.slice(1);
-    
-    // Generate model content based on whether attributes were provided
-    if (dbConfig.attributes && dbConfig.attributes.length > 0) {
-        const attributesStr = dbConfig.attributes.map(attr => {
-            let attrDef = `    ${attr.name}: {\n      type: DataTypes.${attr.type}`;
-            
-            if (attr.length) {
-                attrDef += `(${attr.length})`;
-            }
-            
-            if (attr.primaryKey) {
-                attrDef += `,\n      primaryKey: true,\n      autoIncrement: true`;
-            }
-            
-            if (attr.allowNull === false) {
-                attrDef += `,\n      allowNull: false`;
-            }
-            
-            if (attr.unique) {
-                attrDef += `,\n      unique: true`;
-            }
-            
-            if (attr.defaultValue !== undefined) {
-                attrDef += `,\n      defaultValue: ${JSON.stringify(attr.defaultValue)}`;
-            }
-            
-            attrDef += `\n    }`;
-            return attrDef;
-        }).join(',\n');
-
-        return `'use strict';
+  const modelName = dbConfig.tableName.charAt(0).toUpperCase() + dbConfig.tableName.slice(1);
+
+  // Generate model content based on whether attributes were provided
+  if (dbConfig.attributes && dbConfig.attributes.length > 0) {
+    const attributesStr = dbConfig.attributes.map(attr => {
+      let attrDef = `    ${attr.name}: {\n      type: DataTypes.${attr.type}`;
+
+      if (attr.length) {
+        attrDef += `(${attr.length})`;
+      }
+
+      if (attr.primaryKey) {
+        attrDef += `,\n      primaryKey: true,\n      autoIncrement: true`;
+      }
+
+      if (attr.allowNull === false) {
+        attrDef += `,\n      allowNull: false`;
+      }
+
+      if (attr.unique) {
+        attrDef += `,\n      unique: true`;
+      }
+
+      if (attr.defaultValue !== undefined) {
+        attrDef += `,\n      defaultValue: ${JSON.stringify(attr.defaultValue)}`;
+      }
+
+      attrDef += `\n    }`;
+      return attrDef;
+    }).join(',\n');
+
+    return `'use strict';
 module.exports = (sequelize, DataTypes) => {
   const ${modelName} = sequelize.define('${modelName}', {
 ${attributesStr}
@@ -147,9 +145,9 @@ ${attributesStr}
   return ${modelName};
 };
 `;
-    } else {
-        // Simple model with just ID
-        return `'use strict';
+  } else {
+    // Simple model with just ID
+    return `'use strict';
 module.exports = (sequelize, DataTypes) => {
   const ${modelName} = sequelize.define('${modelName}', {
     id: {
@@ -170,5 +168,5 @@ module.exports = (sequelize, DataTypes) => {
   return ${modelName};
 };
 `;
-    }
+  }
 }

package/lib/testDBConnection.js

@@ -1,39 +1,5 @@
-// const path = require("path");
-
-// async function testDBConnection(targetDir, dbConfig) {
-//     const sequelizePath = path.join(targetDir, "backend", "node_modules", "sequelize");
-//     const { Sequelize } = require(sequelizePath);
-
-//     const sequelize = new Sequelize(
-//         dbConfig.database,
-//         dbConfig.username,
-//         dbConfig.password,
-//         {
-//             host: dbConfig.host,
-//             port: dbConfig.port,
-//             dialect: dbConfig.dialect,
-//             logging: false
-//         }
-//     );
-
-//     try {
-//         await sequelize.authenticate();
-//         console.log(`✅ Connection successful to ${dbConfig.dbKey}`);
-//         await sequelize.close();
-//         return true;
-//     } catch (err) {
-//         console.log(`❌ Failed to connect to ${dbConfig.dbKey}`);
-//         console.log("Error:", err.message);
-//         return false;
-//     }
-// }
-
-// module.exports = testDBConnection;
-
-
-
 const path = require("path");
-const { assertDependency } = require("./utils"); 
+const { assertDependency } = require("./utils");
 
 async function testDBConnection(targetDir, dbConfig) {
     const backendDir = path.join(targetDir, "Backend");