create-express-kickstart 1.2.1 → 1.2.3

package/README.md

@@ -14,14 +14,16 @@ You do not need to clone this repository, install dependencies manually, or writ
 
 ### 1. Initialize a New Project
 
+We highly recommend using the `@latest` tag to ensure you are always downloading the most recent version of our CLI tool dynamically, bypassing any local caching issues!
+
 Run the following command anywhere in your terminal:
 ```bash
-npx create-express-kickstart <your-project-name>
+npx create-express-kickstart@latest <your-project-name>
 ```
 
 **Example:**
 ```bash
-npx create-express-kickstart my-awesome-api
+npx create-express-kickstart@latest my-awesome-api
 ```
 
 ### 2. What happens under the hood?

package/bin/cli.js

@@ -73,7 +73,6 @@ async function init() {
   const initGit = (await question('\n👉 Initialize a git repository? [Y/n] ')).toLowerCase() !== 'n';
   const initDocker = (await question('👉 Include Dockerfile & docker-compose.yml? [Y/n] ')).toLowerCase() !== 'n';
   const initAuth = (await question('👉 Include basic JWT Auth boilerplate? [Y/n] ')).toLowerCase() !== 'n';
-  const useESM = (await question('👉 Use ECMAScript Modules (ESM) over CommonJS? [Y/n] ')).toLowerCase() !== 'n';
   const initTests = (await question('👉 Include Jest setup and boilerplate tests? [Y/n] ')).toLowerCase() !== 'n';
 
   rl.close();
@@ -162,6 +161,69 @@ async function init() {
     );
   }
 
+  // Rewrite app.js and server.js based on selections
+  let appJsPath = path.join(projectPath, 'src', 'app.js');
+  if (fs.existsSync(appJsPath)) {
+    let appJsCode = fs.readFileSync(appJsPath, 'utf8');
+
+    if (initAuth) {
+      appJsCode = appJsCode.replace(
+        '// Import routers',
+        '// Import routers\nimport authRouter from "#routes/auth.routes.js";'
+      );
+      appJsCode = appJsCode.replace(
+        '// Mount routers',
+        '// Mount routers\napp.use("/api/v1/auth", authRouter);'
+      );
+    }
+    if (!deps.cors) {
+      appJsCode = appJsCode.replace(/import cors from "cors";\r?\n/, '');
+      appJsCode = appJsCode.replace(/\/\/ CORS setup[\s\S]*?\n\);\r?\n/, '');
+    }
+    if (!deps.helmet) {
+      appJsCode = appJsCode.replace(/import helmet from "helmet";\r?\n/, '');
+      appJsCode = appJsCode.replace(/\/\/ Security HTTP headers\r?\napp\.use\(helmet\(\)\);\r?\n/, '');
+    }
+    if (!deps['cookie-parser']) {
+      appJsCode = appJsCode.replace(/import cookieParser from "cookie-parser";\r?\n/, '');
+      appJsCode = appJsCode.replace(/app\.use\(cookieParser\(\)\);\r?\n/, '');
+    }
+    if (!deps['pino-http']) {
+      appJsCode = appJsCode.replace(/import pinoHttp from "pino-http";\r?\n/, '');
+      appJsCode = appJsCode.replace(/\/\/ Logging[\s\S]*?\}\)\(\) \? : undefined\n\}\)\);\r?\n/g, ''); // Fallback block 
+      appJsCode = appJsCode.replace(/\/\/ Logging[\s\S]*?\}\)\(\) : undefined\r?\n\}\)\);\r?\n/g, '');
+    }
+    if (!deps['express-rate-limit']) {
+      appJsCode = appJsCode.replace(/import rateLimit from "express-rate-limit";\r?\n/, '');
+      appJsCode = appJsCode.replace(/\/\/ Rate Limiting[\s\S]*?app\.use\("\/api", limiter\);[^\n]*\n/g, '');
+    }
+
+    fs.writeFileSync(appJsPath, appJsCode);
+  }
+
+  let serverJsPath = path.join(projectPath, 'src', 'server.js');
+  if (fs.existsSync(serverJsPath)) {
+    let serverJsCode = fs.readFileSync(serverJsPath, 'utf8');
+    
+    if (!deps.mongoose) {
+      serverJsCode = serverJsCode.replace(/import connectDB from "#db\/index\.js";\r?\n/, '');
+      serverJsCode = serverJsCode.replace(/connectDB\(\)\r?\n    \.then\(\(\) => \{\r?\n/, '');
+      serverJsCode = serverJsCode.replace(/    \}\)\r?\n    \.catch\(\(err\) => \{\r?\n        console\.log\("MONGO db connection failed !!! ", err\);\r?\n    \}\);\r?\n/, '');
+      // Fix indentation for app.listen
+      serverJsCode = serverJsCode.replace(/        app\.listen\(PORT, \(\) => \{\r?\n            console\.log\(`Server is running at port : \$\{PORT\}`\);\r?\n        \}\);\r?\n/, 'app.listen(PORT, () => {\n    console.log(`Server is running at port : ${PORT}`);\n});\n');
+      
+      const dbDir = path.join(projectPath, 'src', 'db');
+      if (fs.existsSync(dbDir)) fs.rmSync(dbDir, { recursive: true, force: true });
+    }
+
+    if (!deps.dotenv) {
+      serverJsCode = serverJsCode.replace(/import dotenv from "dotenv";\r?\n/, '');
+      serverJsCode = serverJsCode.replace(/\/\/ Load environment variables[\s\S]*?\}\);\r?\n/, '');
+    }
+
+    fs.writeFileSync(serverJsPath, serverJsCode);
+  }
+
   // 3. Create package.json
   console.log(`📦 Setting up package.json...`);
   const packageJsonTemplate = {
@@ -169,7 +231,7 @@ async function init() {
     version: "1.0.0",
     description: description || "A production-ready Node.js Express API",
     main: "src/server.js",
-    type: useESM ? "module" : "commonjs",
+    type: "module",
     scripts: {
       "start": "node src/server.js",
       "dev": "nodemon src/server.js"
@@ -187,9 +249,7 @@ async function init() {
   }
 
   if (initTests) {
-    packageJsonTemplate.scripts.test = useESM 
-      ? "node --experimental-vm-modules node_modules/jest/bin/jest.js"
-      : "jest";
+    packageJsonTemplate.scripts.test = "node --experimental-vm-modules node_modules/jest/bin/jest.js";
   }
 
   // Write package.json
@@ -206,7 +266,6 @@ async function init() {
   if (initAuth) {
     dependenciesToInstall.push('jsonwebtoken', 'bcryptjs'); // Add bcryptjs too since it's standard with JWT
   }
-  const depString = dependenciesToInstall.join(' ');
   
   const devDependenciesToInstall = ['nodemon'];
   if (deps.prettier) devDependenciesToInstall.push('prettier');
@@ -214,32 +273,30 @@ async function init() {
   if (initTests) {
     devDependenciesToInstall.push('jest', 'supertest');
   }
-  const devDepString = devDependenciesToInstall.join(' ');
 
-  console.log(`\n⏳ Installing selected core dependencies (${dependenciesToInstall.join(', ')}). This might take a minute...`);
   try {
-    let installCmd = packageManager === 'yarn' ? 'yarn add' 
-      : packageManager === 'pnpm' ? 'pnpm add'
-      : packageManager === 'bun' ? 'bun add'
-      : 'npm install';
-      
-    let installDevCmd = packageManager === 'yarn' ? 'yarn add -D' 
-      : packageManager === 'pnpm' ? 'pnpm add -D'
-      : packageManager === 'bun' ? 'bun add -d'
-      : 'npm install --save-dev';
-
-    if (depString) {
-      execSync(`${installCmd} ${depString}`, { 
-        cwd: projectPath, 
-        stdio: 'inherit' 
-      });
-    }
+    const execConfig = { cwd: projectPath, stdio: 'inherit' };
+    
+    // Inject dependencies directly into package.json instead of doing them via raw arguments.
+    // This perfectly bypasses PNPM / YARN / BUN specific registry caching bugs when downloading deeply nested trees.
+    console.log(`\n⏳ Configuring ${packageManager} and resolving dependency trees...`);
+    const finalPackageJsonPath = path.join(projectPath, 'package.json');
+    const finalPackageJsonCode = JSON.parse(fs.readFileSync(finalPackageJsonPath, 'utf8'));
     
-    console.log(`\n⏳ Installing latest dev dependencies (${devDepString})...`);
-    execSync(`${installDevCmd} ${devDepString}`, { 
-      cwd: projectPath, 
-      stdio: 'inherit' 
-    });
+    // We add them dynamically so package managers can evaluate them holistically at once
+    const latestDeps = {};
+    dependenciesToInstall.forEach(d => latestDeps[d] = 'latest');
+    finalPackageJsonCode.dependencies = latestDeps;
+
+    const latestDevDeps = {};
+    devDependenciesToInstall.forEach(d => latestDevDeps[d] = 'latest');
+    finalPackageJsonCode.devDependencies = latestDevDeps;
+    
+    fs.writeFileSync(finalPackageJsonPath, JSON.stringify(finalPackageJsonCode, null, 2));
+
+    console.log(`\n⏳ Running final installation via ${packageManager} (This might take a minute)...`);
+    const installTriggerCmd = packageManager === 'npm' ? 'npm install' : `${packageManager} install`;
+    execSync(installTriggerCmd, execConfig);
 
     if (initGit) {
       console.log(`\n🌱 Initializing Git repository...`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-express-kickstart",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Production-ready CLI starter for Express APIs",
   "main": "bin/cli.js",
   "bin": {

package/templates/auth/auth.routes.js

@@ -1,6 +1,6 @@
 import { Router } from 'express';
-import { authController } from '../controllers/auth.controller.js';
-import { authMiddleware } from '../middlewares/auth.middleware.js';
+import { authController } from '#controllers/auth.controller.js';
+import { authMiddleware } from '#middlewares/auth.middleware.js';
 
 const router = Router();
 

package/templates/tests/healthcheck.test.js

@@ -7,6 +7,6 @@ describe('Healthcheck API', () => {
     
     expect(response.status).toBe(200);
     expect(response.body.success).toBe(true);
-    expect(response.body.message).toBe('Api is runing properly');
+    expect(response.body.message).toBe('App is running smoothly');
   });
 });